Edit

DXGKARGCB_CREATECONTEXTALLOCATION structure (d3dkmddi.h)

  • Article

The DXGKARGCB_CREATECONTEXTALLOCATION structure contains the allocation attributes of a GPU context or device-specific context used in the DXGKCB_CREATECONTEXTALLOCATION callback function.

Syntax

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Members

[in] ContextAllocationFlags

A DXGK_CREATECONTEXTALLOCATIONFLAGS structure that specifies the properties of the allocation.

[in] hAdapter

A handle to the graphics adapter for which the context allocation is created.

[in] hDevice

A handle to the display device that was originally passed by the DirectX graphics subsystem to the display miniport driver's DxgkDdiCreateDevice function.

Note

This member is set to NULL for a system device.

[in] hContext

If ContextAllocationFlags.SharedAcrossContexts is set to a value of 0, this member contains the value assigned by the DirectX graphics subsystem for the context that was passed to the DXGKCB_CREATECONTEXTALLOCATION function.

If ContextAllocationFlags.SharedAcrossContexts is set to a value of 1, this member should be set to NULL.

Note

This member is also set to NULL for a system context.

[in] hDriverAllocation

A handle created by the display miniport driver that identifies the created allocation. The value of this member is subsequently passed as the Transfer.hAllocation member of the DXGKARG_BUILDPAGINGBUFFER structure that is pointed to by the pBuildPagingBuffer parameter of the DxgkDdiBuildPagingBuffer function.

[in] Size

The size, in bytes, that is required for the allocation.

[in] Alignment

The required alignment, in bytes, for the allocation.

[in] SupportedSegmentSet

Segment identifiers that the display miniport driver can set in the PreferredSegment member for read or write operations.

[in] EvictionSegmentSet

Identifiers of segments that can be used for eviction.

[in] PreferredSegment

A DXGK_SEGMENTPREFERENCE structure that indicates the preferred segment identifiers that the display miniport driver requests that the video memory manager use to page-in the allocation.

[in] HintedBank

A DXGK_SEGMENTBANKPREFERENCE structure that indicates the bank ordering preferences that the display miniport driver requests that the video memory manager use to page-in the allocation.

[in] Flags

A DXGK_ALLOCATIONINFOFLAGS structure that identifies properties for an allocation in bit-field flags. These properties indicate the type of allocation to create. The display miniport driver specifies these flags for the video memory manager. See Remarks for restrictions on flag values.

[out] hAllocation

A handle that has been assigned by the DirectX graphics subsystem to the allocation. This value is subsequently passed as the hAllocation parameter of the DXGKCB_DESTROYCONTEXTALLOCATION function.

[in] PhysicalAdapterIndex

The index of the physical adapter. This field is available starting in WDDM 2.0.

Remarks

The display miniport driver calls DXGKCB_CREATECONTEXTALLOCATION to allocate a GPU context or device-specific context. When the driver calls this function, it passes a pointer to a DXGKARGCB_CREATECONTEXTALLOCATION structure through the ContextAllocation parameter.

Requirements

Requirement Value
Minimum supported client Windows 8 (WDDM 1.2)
Minimum supported server Windows Server 2012
Header d3dkmddi.h (include D3dkmddi.h)

See also

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION