DXGKDDI_DESCRIBEALLOCATION コールバック関数 (d3dkmddi.h)
DxgkDdiDescribeAllocation 関数は、Microsoft DirectX グラフィックス カーネル サブシステムでは使用できない既存の割り当てに関する情報を取得します。
構文
DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;
NTSTATUS DxgkddiDescribeallocation(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで DirectX グラフィックス カーネル サブシステムにこのハンドルを以前に提供しました。
[in/out] pDescribeAllocation
既存の割り当てを記述する DXGKARG_DESCRIBEALLOCATION 構造体へのポインター。
戻り値
DxgkDdiDescribeAllocation は成功した場合、STATUS_SUCCESSを返します。それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
DirectX グラフィックス カーネル サブシステムは割り当てのレコードを必ずしも保持する必要がないため、グラフィックス カーネル サブシステムは DxgkDdiDescribeAllocation を呼び出して、ディスプレイ ミニポート ドライバーが既存の割り当てに関する情報を返すように要求します。 現在、ディスプレイ ミニポート ドライバーは、次の割り当てのこの情報を返すことができる必要があります。
- また、プライマリである割り当て (つまり、pfnAllocateCb 関数の呼び出しで、D3DDDI_ALLOCATIONINFO構造体の Flags メンバーでプライマリ ビット フィールド フラグを設定することによってユーザー モードディスプレイ ドライバーが作成した割り当て)。
- プレゼンテーションのソースである可能性がある割り当て (つまり、ディスプレイ ミニポート ドライバーの DxgkDdiPresent 関数の呼び出しでDXGKARG_PRESENT構造体の hSource メンバーによって表される割り当て)。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
対象プラットフォーム | デスクトップ |
Header | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |