Flags used in the creation of deferred contexts.
typedef enum D3D11_CREATE_DEFERRED_CONTEXT_FLAG
{
D3D11_CREATE_DEFERRED_CONTEXT_LONG_LIFE_COMMAND_LISTS = 0x10000,
D3D11_CREATE_DEFERRED_CONTEXT_DRAW_BUNDLES = 0x20000,
D3D11_CREATE_DEFERRED_CONTEXT_TITLE_MANAGED_COMMAND_LIST_OBJECT_LIFETIMES = 0x40000,
D3D11_CREATE_DEFERRED_CONTEXT_FAST_SEMANTICS = 0x80000
} D3D11_CREATE_DEFERRED_CONTEXT_FLAG;
| Constant | Description |
|---|---|
| D3D11_CREATE_DEFERRED_CONTEXT_LONG_LIFE_COMMAND_LISTS | This flag is useful for PIX capture purposes. It indicates that the Command Lists or Draw Bundles created with this Deferred Context will be long lived (that is, required in a later frame). To allow those Command Lists to be examinable when a PIX GPU capture is done, Direct3D saves additional metadata to provide sufficient data for inspecting the contents of the Command List. However, this flag adds considerable CPU and memory overhead when the Command List is created. If the Command List is generated with a frame of the GPU capture then this flag is not needed while still allowing full PIX functionality. |
| D3D11_CREATE_DEFERRED_CONTEXT_DRAW_BUNDLES | Draw Bundles are created by recording state and draw calls using special Deferred Contexts. Such a Deferred Context must be created by passing the D3D11_CREATE_DEFERRED_CONTEXT_DRAW_BUNDLES flag to ID3D11Device::CreateDeferredContext or ID3D11Device1::CreateDeferredContext1. The resulting Deferred Context may be used only for Draw Bundle recording. See Draw Bundles. |
| D3D11_CREATE_DEFERRED_CONTEXT_TITLE_MANAGED_COMMAND_LIST_OBJECT_LIFETIMES | This flag reduces Command List record times and Command List Release overhead. Default behavior is to include the overhead to implement correct Direct3D refcounting semantics on objects. This flag allows you to avoid that overhead if your title is managing Direct3D object lifetimes. |
| D3D11_CREATE_DEFERRED_CONTEXT_FAST_SEMANTICS | Creates an immediate context with fast semantics. Applies fast semantics at context granularity. See Optimizing Monolithic Driver Performance; Fast Semantics; Fast Semantics Render Loops. |
This enumeration constant is used by the methods ID3D11Device::CreateDeferredContext and ID3D11Device1::CreateDeferredContext1.
Header: Declared in d3d11_x.h (d3d11_1.h on other Windows platforms).
Library: Use d3d11_x.lib (d3d11.lib on other Windows platforms).