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 |
| ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |
関連項目
DXGK_CREATECONTEXTALLOCATIONFLAGS