DXGKDDI_VALIDATESUBMITCOMMAND コールバック関数 (d3dkmddi.h)
カーネル モードディスプレイ ミニポートの (KMD) DXGKDDI_VALIDATESUBMITCOMMAND 関数は、ユーザー モード ドライバー (UMD) が D3DKMTSubmitCommand または D3DKMTSubmitCommandToHwQueue への呼び出しで渡すプライベート ドライバー データを検証します。
構文
DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;
NTSTATUS DxgkddiValidatesubmitcommand(
IN_CONST_HANDLE hContext,
INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}
パラメーター
hContext
[入力] KMD が DxgkDdiAddDevice から返したミニポート デバイス コンテキストへのハンドル。
pArgs
[入力/出力]submit コマンドを検証するために必要な情報を含む DXGKARG_VALIDATESUBMITCOMMAND 構造体へのポインター。
戻り値
DXGKDDI_VALIDATESUBMITCOMMAND は、次のいずれかの NTSTATUS 値を返します。
- STATUS_SUCCESS
- STATUS_INVALID_USER_BUFFER
注釈
KMD がこのコールバックを実装すると、KMD は常に次の呼び出しで渡されたプライベート データを検証します。
このコールバックは、D3DKMTSubmitCommand のプライベート ドライバー サイズ (DmaBufferPrivateDataSize) が 0 でない場合にのみ呼び出されます。
これは、 D3DKMTSubmitCommand または D3DKMTSubmitCommandToHwQueue ごとに 1 回呼び出されます。
KMD では、 D3DKMTSubmitCommand を呼び出したプロセスのコンテキストでこのコールバックが呼び出されるとは想定しないでください。 そのため、UMD は、プライベート データ内のユーザー モード ポインターまたはハンドルを渡さないでください。
このコールバックは、コマンドが実行のために GPU スケジューラ ソフトウェア キューに送信される前に呼び出されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 Version 1809 |
Header | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |