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 関数の出力パラメーター ミニポートDeviceContext の DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in/out] pDescribeAllocation
既存の割り当てを記述する DXGKARG_DESCRIBEALLOCATION 構造体へのポインター。
戻り値
DxgkDdiDescribeAllocation 成功した場合、STATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.hで定義されているエラー コードの 1 つを返します。
備考
DirectX グラフィックス カーネル サブシステムは割り当てのレコードを必ずしも保持するわけではないため、グラフィックス カーネル サブシステムは DxgkDdiDescribeAllocation 呼び出して、ディスプレイ ミニポート ドライバーが既存の割り当てに関する情報を返すように要求します。 現在、ディスプレイ ミニポート ドライバーは、次の割り当てのこの情報を返すことができる必要があります。
- プライマリでもある割り当て (つまり、pfnAllocateCb 関数の呼び出しで、D3DDDI_ALLOCATIONINFO 構造体の Flags メンバーに Primary ビット フィールド フラグを設定することによってユーザー モード ディスプレイ ドライバーが作成した割り当て)。
- プレゼンテーションのソースである可能性がある割り当て (つまり、ディスプレイ ミニポート ドライバーの DxgkDdiPresent 関数の呼び出しで DXGKARG_PRESENT 構造体の hSource メンバーによって表される割り当て)。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
関連項目
DxgkDdiAddDevice の
pfnAllocateCb の