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 関数に渡されたディスプレイ デバイスへのハンドル。

[in] hContext

ContextAllocationFlags.SharedAcrossContexts が値 0 に設定されている場合、このメンバーには、DXGKCB_CREATECONTEXTALLOCATION関数に渡されたコンテキストに対して DirectX グラフィックス サブシステムによって割り当てられた値が含まれます。

ContextAllocationFlags.SharedAcrossContexts が値 1 に設定されている場合、このメンバーは 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 以降で使用できます。

注釈

ディスプレイ ミニポート ドライバーは、GPU コンテキストまたはデバイス固有 の コンテキストを割り当てるためにDXGKCB_CREATECONTEXTALLOCATIONを呼び出します。 ドライバーは、この関数を呼び出すと、ContextAllocation パラメーターを介してDXGKARGCB_CREATECONTEXTALLOCATION構造体へのポインターを渡します。

要件

こちらもご覧ください

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION