DXGKDDI_DESCRIBEALLOCATION コールバック関数 (d3dkmddi.h)

[アーティクル]
02/23/2024

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 メンバーによって表される割り当て)。

DxgkDdiDescribeAllocation をページング可能にする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL