D3DKMTSubmitCommand 関数 (d3dkmthk.h)

D3DKMTSubmitCommand は、グラフィックス処理装置 (GPU) 仮想アドレス指定をサポートするコンテキストでコマンド バッファーを送信するために使用されます。 これらのコンテキストは、ユーザー モードから直接コマンドを生成し、独自のコマンド バッファー プールを管理し、割り当てまたはパッチの場所の一覧を使用しません。

構文

NTSTATUS D3DKMTSubmitCommand(
  [in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);

パラメーター

[in] unnamedParam1

操作を記述する D3DKMT_SUBMITCOMMAND 構造体へのポインター。

戻り値

リターン コード	説明
STATUS_SUCCESS	デバイス コンテキストが正常に作成されました。
STATUS_INVALID_PARAMETER	パラメーターが検証され、正しくないと判断されました。

この関数は、他の NTSTATUS 値も 返す場合があります。

注釈

この関数は、このようなコンテキストの古い Render 関数を置き換え、その代わりに使用する必要があります。 従来のパッチ モードで動作するコンテキストでは、引き続き古い Render 関数を使用する必要があります。

ユーザー モード ドライバーはパッチの場所を生成しませんが、書き込まれるプライマリの一覧を生成する必要があります。 ビデオ メモリ マネージャーは、割り当てリストを使用して、各コマンド バッファーによって書き込み用に参照されているプライマリ割り当てを決定します。 この情報は、 反転 操作を使用して、レンダリングをプライマリに同期するために使用されます。

一部のカーネル モード ドライバーでは、特定のダイレクト メモリ アクセス (DMA) バッファーを GPU に送信する方法に関するユーザー モード ドライバーからの情報が必要です。 Windows Display Driver Model (WDDM) 1.0 では、この情報はユーザー モード ドライバーからコマンド バッファーを介してカーネル モード ドライバーに送信されました。 DMA バッファーはユーザー モード ドライバーによって直接構築され、変更なしで GPU に送信されるため、カーネル ドライバーに情報を送信するために使用できなくなります。 ユーザー モード ドライバーとカーネル モード ドライバーの間で情報の転送を有効にするために、送信と共に送信される明示的なプライベート ドライバー データ バッファーが追加されました。

注意

このプライベート ドライバー データは一方向であり、カーネル モード ドライバーはこのバッファーを介してユーザー モード ドライバーに情報を返すことはできません。

要件

要件	値
サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	Windows Server 2016
対象プラットフォーム	ユニバーサル
Header	d3dkmthk.h (D3dkmthk.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

こちらもご覧ください

D3DKMT_SUBMITCOMMAND