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

由显示微型端口驱动程序创建的句柄,用于标识已创建的分配。 此成员的值随后作为DXGKARG_BUILDPAGINGBUFFER结构的 Transfer.hAllocation 成员传递,该结构由 DxgkDdiBuildPagingBuffer 函数的 pBuildPagingBuffer 参数所指向。

[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
Header d3dkmddi.h (包括 D3dkmddi.h)

另请参阅

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION