DXGKDDI_VALIDATESUBMITCOMMAND コールバック関数 (d3dkmddi.h)
カーネル モードディスプレイ ミニポートの (KMD) DXGKDDI_VALIDATESUBMITCOMMAND 関数は、ユーザー モード ドライバー (UMD) が D3DKMTSubmitCommandまたはD3DKMTSubmitCommandToHwQueueへの呼び出しで渡すプライベート ドライバー データを検証します。
構文
DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;
NTSTATUS DxgkddiValidatesubmitcommand(
IN_CONST_HANDLE hContext,
INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}
パラメーター
hContext
[in]ミニポート デバイス コンテキストへのハンドル。DXgkDdiAddDevice から返された KMD。
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 バージョン 1809 |
ヘッダー | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |