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の