次の方法で共有


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

KMD の DXGKDDI_BUILDTESTCOMMANDBUFFER 関数は、カーネル モードのテスト するためのテスト コマンド バッファーを構築します。

構文

DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;

NTSTATUS DxgkddiBuildtestcommandbuffer(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}

パラメーター

hAdapter

[in]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 カーネル モードディスプレイ ミニポート ドライバー (KMD) は、以前にこのハンドルを指定して、ミニポートDeviceContext 出力パラメーターの DxgkddiAddDevice関数の出力パラメーターを dxgkrnl しました。

pArgs

[入力/出力]ビルドするテスト コマンド バッファーを記述する DXGKARG_BUILDTESTCOMMANDBUFFER 構造体へのポインター。

戻り値

DXGKDDI_BUILDTESTCOMMANDBUFFER は、関数が成功した場合にNTSTATUS_SUCCESSを返します。 それ以外の場合は、STATUS_BUFFER_OVERFLOWなどの適切な NTSTATUS コードが返されます。

備考

DXGKDDI_BUILDTESTCOMMANDBUFFER は、一連の単純なコマンドのデバイス固有の命令を含むコマンド バッファーを構築します。 KMD は、DxgkDdiQueryFeatureInterface(DXGK_FEATURE_KERNEL_MODE_TESTING) を使用して、pfnBuildTestCommandBuffer でこの関数へのポインターを返します。

pDmaBuffer が NULL または小さすぎる場合、KMD は DmaBufferSize 内のバッファーに必要なサイズ 設定し、STATUS_BUFFER_OVERFLOWを返す必要があります。

pDmaBufferPrivateData が NULL または小さすぎる、KMD でプライベート データを生成する必要がある場合、KMD は DmaBufferPrivateDataSize で必要なサイズ 設定し、STATUS_BUFFER_OVERFLOWを返す必要があります。

KMD は、同じ呼び出しの両方のバッファーのサイズを計算する必要があります。

詳細については、カーネル モードのテストを参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 11 バージョン 24H2 (WDDM 3.2)
ヘッダー d3dkmddi.h
IRQL PASSIVE_LEVEL

関連項目

DXGKARG_BUILDTESTCOMMANDBUFFER

DxgkDdiQueryFeatureInterface