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 に設定されている場合、このメンバーには、DXGKCB_CREATECONTEXTALLOCATION関数に渡されたコンテキストに対して DirectX グラフィックス サブシステムによって割り当てられた値が含まれます。
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 以降で使用できます。
注釈
ディスプレイ ミニポート ドライバーは、GPU コンテキストまたはデバイス固有 の コンテキストを割り当てるためにDXGKCB_CREATECONTEXTALLOCATIONを呼び出します。 ドライバーは、この関数を呼び出すと、ContextAllocation パラメーターを介してDXGKARGCB_CREATECONTEXTALLOCATION構造体へのポインターを渡します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 (WDDM 1.2) |
| サポートされている最小のサーバー | Windows Server 2012 |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
こちらもご覧ください
DXGK_CREATECONTEXTALLOCATIONFLAGS