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

DxgkDdiGetStandardAllocationDriverData 関数は、標準割り当ての種類の説明を返します。

構文

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

パラメーター

[in] hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 カーネル モード ディスプレイ ドライバー (KMD) は以前、このハンドルを提供して、DxgkDdiAddDevice 関数 dxgkrnl を しました。

[in/out] pGetStandardAllocationDriverData

標準割り当てを記述するDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 構造体へのポインター。

戻り値

DxgkDdiGetStandardAllocationDriverData 、次のいずれかの値が返されます。

リターン コード	形容
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData 、標準割り当ての種類の説明が正常に返されました。
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData 完了するために必要なメモリを割り当てられませんでした。

備考

標準の割り当ての種類 は、ユーザー モードのディスプレイ ドライバーからの通信なしでカーネル モードで作成する必要がある割り当てです。

Dxgkrnl 、カーネル モード ドライバー (KMD) DxgkDdiGetStandardAllocationDriverData 関数を呼び出して、pGetStandardAllocationDriverData パラメーターが指定する標準割り当ての種類の説明を生成します。 KMD は、pAllocationPrivateDriverData 内の割り当ての種類の説明を返し、pGetStandardAllocationDriverData パラメーターが指す DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 構造体の pResourcePrivateDriverData メンバーを します。 Dxgkrnl は、その後、DxgkDdiCreateAllocation 関数に説明を渡して、実際に割り当てを作成します。

Windows 7 以降、KMD が DxgkDdiGetStandardAllocationDriverData 関数への呼び出しを処理して GDI ハードウェア アクセラレーションの割り当てを作成する場合、ドライバーは CPU に表示される割り当てのピッチを設定する必要があります。**pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch。

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

関連項目

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice の

DxgkDdiCreateAllocation を する