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

こちらもご覧ください

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA

DxgkDdiAddDevice

DxgkDdiCreateAllocation