DXGKARGCB_CREATECONTEXTALLOCATION 结构 (d3dkmddi.h)
DXGKARGCB_CREATECONTEXTALLOCATION 结构包含DXGKCB_CREATECONTEXTALLOCATION回调函数中使用的 GPU 上下文或特定于设备的上下文的分配属性。
语法
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;
成员
[in] ContextAllocationFlags
一个DXGK_CREATECONTEXTALLOCATIONFLAGS结构,用于指定分配的属性。
[in] hAdapter
为其创建上下文分配的图形适配器的句柄。
[in] hDevice
显示设备的句柄,该句柄最初由 DirectX 图形子系统传递给显示微型端口驱动程序的 DxgkDdiCreateDevice 函数。
注意
对于系统设备,此成员设置为 NULL。
[in] hContext
如果将 ContextAllocationFlags.SharedAcrossContexts 设置为值 0,则此成员包含由 DirectX 图形子系统为传递给 DXGKCB_CREATECONTEXTALLOCATION 函数的上下文分配的值。
如果将 ContextAllocationFlags.SharedAcrossContexts 设置为值 1,则此成员应设置为 NULL。
注意
对于系统上下文,此成员也设置为 NULL。
[in] hDriverAllocation
由显示微型端口驱动程序创建的句柄,用于标识创建的分配。 随后,此成员的值将作为 dxgkDdiBuildPagingBuffer 函数的 pBuildPagingBuffer 参数指向的 DXGKARG_BUILDPAGINGBUFFER 结构的 Transfer.hAllocation 成员传递。
[in] Size
分配所需的大小(以字节为单位)。
[in] Alignment
分配所需的对齐方式(以字节为单位)。
[in] SupportedSegmentSet
显示微型端口驱动程序可以在 PreferredSegment 成员中为读取或写入操作设置的段标识符。
[in] EvictionSegmentSet
可用于逐出的段的标识符。
[in] PreferredSegment
DXGK_SEGMENTPREFERENCE结构,指示显示微型端口驱动程序请求视频内存管理器用于分页分配的首选段标识符。
[in] HintedBank
DXGK_SEGMENTBANKPREFERENCE结构,指示显示微型端口驱动程序请求视频内存管理器用于分页分配的银行订购首选项。
[in] Flags
一种DXGK_ALLOCATIONINFOFLAGS结构,用于标识位字段标志中分配的属性。 这些属性指示要创建的分配类型。 显示微型端口驱动程序为视频内存管理器指定这些标志。 有关标志值的限制,请参阅备注。
[out] hAllocation
DirectX 图形子系统已分配给分配的句柄。 此值随后作为DXGKCB_DESTROYCONTEXTALLOCATION函数的 hAllocation 参数传递。
[in] PhysicalAdapterIndex
物理适配器的索引。 从 WDDM 2.0 开始,此字段可用。
注解
显示微型端口驱动程序调用 DXGKCB_CREATECONTEXTALLOCATION 来分配 GPU 上下文或特定于设备的上下文。 当驱动程序调用此函数时,它会通过 ContextAllocation 参数传递指向 DXGKARGCB_CREATECONTEXTALLOCATION 结构的指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 (WDDM 1.2) |
最低受支持的服务器 | Windows Server 2012 |
标头 | d3dkmddi.h (包括 D3dkmddi.h) |
另请参阅
DXGK_CREATECONTEXTALLOCATIONFLAGS