DXGKARGCB_CREATECONTEXTALLOCATION結構（d3dkmddi.h）

發行項
02/06/2025

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

顯示迷你埠驅動程式所建立的句柄，可識別所建立的配置。此成員的值後續會當做 Transfer.hAllocationDXGKARG_BUILDPAGINGBUFFER 結構的成員傳遞，pBuildPagingBufferDxgkDdiBuildPagingBuffer 函式所指向。

[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 結構。