DXGKARGCB_CREATECONTEXTALLOCATION structure (d3dkmddi.h)
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_CREATECONTEXTALLOCATIONFLAGS