Export (0) Print
Expand All
Expand Minimize

DXGKARGCB_CREATECONTEXTALLOCATION structure

Specifies the allocation attributes of a GPU context or device-specific context.

Syntax


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

Members

ContextAllocationFlags

[in] A DXGK_CREATECONTEXTALLOCATIONFLAGS structure that specifies the properties of the allocation.

hAdapter

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

hDevice

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

Note  The member is set to NULL for a system device.

hContext

[in] 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 DxgkCbCreateContextAllocation function.

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

Note  The member is also set to NULL for a system context.

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.

Size

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

Alignment

[in] The required alignment, in bytes, for the allocation.

SupportedSegmentSet

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

EvictionSegmentSet

[in] Identifiers of segments that can be used for eviction.

PreferredSegment

[in] 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.

HintedBank

[in] 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.

Flags

[in] 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.

hAllocation

[out] 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 DxgkCbDestroyContextAllocation function.

Remarks

The display miniport driver calls DxgkCbCreateContextAllocation 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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dkmddi.h (include D3dkmddi.h)

See also

DXGK_ALLOCATIONINFOFLAGS
DXGK_CREATECONTEXTALLOCATIONFLAGS
DXGK_SEGMENTBANKPREFERENCE
DXGK_SEGMENTPREFERENCE
DxgkCbCreateContextAllocation

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft