Edit

D3DKMT_CREATECONTEXT structure (d3dkmthk.h)

  • Article

The D3DKMT_CREATECONTEXT structure is used with D3DKMTCreateContext to create a kernel-mode device context.

Syntax

typedef struct _D3DKMT_CREATECONTEXT {
  D3DKMT_HANDLE             hDevice;
  UINT                      NodeOrdinal;
  UINT                      EngineAffinity;
  D3DDDI_CREATECONTEXTFLAGS Flags;
  VOID                      *pPrivateDriverData;
  UINT                      PrivateDriverDataSize;
  D3DKMT_CLIENTHINT         ClientHint;
  D3DKMT_HANDLE             hContext;
  VOID                      *pCommandBuffer;
  UINT                      CommandBufferSize;
  D3DDDI_ALLOCATIONLIST     *pAllocationList;
  UINT                      AllocationListSize;
  D3DDDI_PATCHLOCATIONLIST  *pPatchLocationList;
  UINT                      PatchLocationListSize;
  D3DGPU_VIRTUAL_ADDRESS    CommandBuffer;
} D3DKMT_CREATECONTEXT;

Members

hDevice

[in] A handle to the device that owns the context being created.

NodeOrdinal

[in] The zero-based index of the node that the context is scheduled on.

EngineAffinity

[in] The zero-based index for the engine, within the node that NodeOrdinal specifies, that the context can run in.

Flags

[in] A D3DDDI_CREATECONTEXTFLAGS structure that indicates, in bit-field flags, how to create the context.

pPrivateDriverData

[in] A pointer to private data that is to be passed to the display miniport driver.

PrivateDriverDataSize

[in] The size, in bytes, of the private data that pPrivateDriverData points to.

ClientHint

[in] A D3DKMT_CLIENTHINT value that indicates the type of client that is creating the context.

hContext

[out] A handle to the created device context.

pCommandBuffer

[out] Pointer to an array of allocated command buffers in which the OpenGL ICD can place commands into.

CommandBufferSize

[out] The size, in bytes, of the memory block that pCommandBuffer points to.

pAllocationList

[out] Pointer to an array of D3DDDI_ALLOCATIONLIST structures that the OpenGL ICD can insert referenced allocations in.

AllocationListSize

[out] The number of elements in the array of allocations that pAllocationList points to. This quantity of allocations is available when Dxgkrnl submits the command buffer that is pointed to by pCommandBuffer to the display miniport driver.

pPatchLocationList

[out] Pointer to an allocated array of D3DDDI_PATCHLOCATIONLIST structures that the OpenGL ICD inserts patching information in.

PatchLocationListSize

[out] The number of elements in the patch-location list that pPatchLocationList points to. This quantity of patch locations is available when Dxgkrnl submits the command buffer that is pointed to by pCommandBuffer to the display miniport driver.

CommandBuffer

[out] The GPU virtual address of the command buffer memory.

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DDDI_ALLOCATIONLIST

D3DDDI_CREATECONTEXTFLAGS

D3DDDI_PATCHLOCATIONLIST

D3DKMTCreateContext