DXGKARGCB_CREATECONTEXTALLOCATION 结构 (d3dkmddi.h)

项目
02/26/2024

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 结构的指针。