DXGKARGCB_CREATECONTEXTALLOCATION 結構 (d3dkmddi.h)

發行項
02/25/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結構的指標。