DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA コールバック関数 (d3dkmddi.h)
DxgkDdiGetStandardAllocationDriverData 関数は、標準割り当ての種類の説明を返します。
構文
DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;
NTSTATUS DxgkddiGetstandardallocationdriverdata(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in/out] pGetStandardAllocationDriverData
標準割り当てを記述する DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 構造体へのポインター。
戻り値
DxgkDdiGetStandardAllocationDriverData は、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
STATUS_SUCCESS | DxgkDdiGetStandardAllocationDriverData は、標準割り当ての種類の説明を正常に返しました。 |
STATUS_NO_MEMORY | DxgkDdiGetStandardAllocationDriverData は、完了するために必要なメモリを割り当てませんでした。 |
注釈
標準割り当ての種類 は、ユーザー モード ディスプレイ ドライバーからの通信なしでカーネル モードで作成する必要がある割り当てです。 DirectX グラフィックス カーネル サブシステムは 、DxgkDdiGetStandardAllocationDriverData 関数を呼び出して、 pGetStandardAllocationDriverData パラメーターが指定する標準割り当ての種類の説明を生成します。 ディスプレイ ミニポート ドライバーは、pGetStandardAllocationDriverData パラメーターが指すDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA構造体の pAllocationPrivateDriverData メンバーと pResourcePrivateDriverData メンバーの割り当ての種類の説明を返します。 DirectX グラフィックス カーネル サブシステムは、その後、 DxgkDdiCreateAllocation 関数に説明を渡して、実際に割り当てを作成します。
Windows 7 以降では、ディスプレイ ミニポート ドライバーが DXgkDdiGetStandardAllocationDriverData 関数の呼び出しを処理して GDI ハードウェア アクセラレータの割り当てを作成する場合、ドライバーは CPU の可視割り当て pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>> の割り当てのピッチを設定する必要があります。
DxgkDdiGetStandardAllocationDriverData をページング可能にする必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
対象プラットフォーム | デスクトップ |
Header | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |