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

[アーティクル]
02/06/2025

GDI ハードウェアアクセラレーションをサポートするディスプレイアダプターの場合、DxgkDdiRenderKm 関数は、カーネルモード正規ディスプレイドライバー (CDD) が渡したコマンドバッファーから直接メモリアクセス (DMA) バッファーを生成します。

構文

DXGKDDI_RENDERKM DxgkddiRenderkm;

NTSTATUS DxgkddiRenderkm(
  [in]     IN_CONST_HANDLE hContext,
  [in/out] INOUT_PDXGKARG_RENDER pRenderKmArgs
)
{...}

パラメーター

[in] hContext

DMA バッファーとコマンドバッファーのデバイスコンテキストへのハンドル。ディスプレイミニポートドライバーの DxgkDdiCreateContext 関数は、以前に、dxgkDdiCreateContext の pCreateContext パラメーターが指す DXGKARG_CREATECONTEXT 構造体の hContext メンバー このハンドルを返しました。

ドライバーがコンテキストの作成をサポートしていない場合、Microsoft DirectX グラフィックスカーネルサブシステムは、コンテキストへのハンドルをデバイスへのハンドルに置き換えます。ディスプレイミニポートドライバーの DxgkDdiCreateDevice 関数は、以前、dxgkDdiCreateDevice の pCreateDevice パラメーターが指す DXGKARG_CREATEDEVICE 構造体の hDevice メンバー内のデバイスハンドル 返しました。

[in/out] pRenderKmArgs

DMA バッファーと書式設定されたコマンドバッファーに関する情報を含む DXGKARG_RENDER 構造体へのポインター。

ディスプレイミニポートドライバーが GDI ハードウェアアクセラレーションをサポートしている場合は、pRenderKmArgs - pCommand>、DXGK_RENDERKM_COMMAND コマンドバッファーを指します。

ドライバーは、入力コマンドバッファーを DMA バッファーコマンドに変換し、パッチの場所の一覧をビルドする必要があります。

戻り値

DxgkDdiRenderKm は、次のいずれかの値を返します。

リターンコード	説明
STATUS_SUCCESS	コマンドバッファー全体が変換されました。
STATUS_NO_MEMORY	DxgkDdiRenderKm 、完了するために必要なメモリを割り当てませんでした。
STATUS_GRAPHICS_INSUFFICIENT_DMA_BUFFER	現在の DMA バッファーが使い果たされました。
STATUS_INVALID_PARAMETER	DxgkDdiRenderKm 、グラフィックスハードウェアでサポートできなかった命令パラメーターが検出。ただし、グラフィックスハードウェアは命令自体をサポートできます。ドライバーは、このエラーコードを返す必要はありません。代わりに、サポートされていない命令パラメーターを検出したときにSTATUS_ILLEGAL_INSTRUCTIONを返すことができます。
STATUS_INVALID_USER_BUFFER	DxgkDdiRenderKm 、検出されたデータまたは命令のアンダーランまたはオーバーラン。つまり、ドライバーが受け取った命令またはデータが予想よりも少ないか、またはそれ以上でした。ドライバーは、このエラーコードを返す必要はありません。代わりに、データまたは命令のアンダーランまたはオーバーランを検出したときにSTATUS_ILLEGAL_INSTRUCTIONを返すことができます。
STATUS_INVALID_HANDLE	DxgkDdiRenderKm コマンドバッファーで無効なハンドルが検出されました。
STATUS_GRAPHICS_GPU_EXCEPTION_ON_DEVICE	ディスプレイミニポートドライバーが DMA ストリームでエラーを検出しました。ドライバーがこのエラーコードを返した場合、グラフィックスコンテキストデバイスは失われた状態になります。

備考

DirectX グラフィックスカーネルサブシステムは、ディスプレイミニポートドライバーの DxgkDdiRenderKm 関数を呼び出して、オペレーティングシステムによって提供されるカーネルモード正規ディスプレイドライバー (CDD) によって渡されるコマンドバッファーから DMA バッファーを生成します。出力 DMA バッファーに加えて、ディスプレイミニポートドライバーも出力パッチの場所の一覧を生成する必要があります。ビデオメモリマネージャーでは、この一覧を使用して DMA バッファーを適切に分割および修正します。

カーネルバッファーへのアクセスには、try/except コードからの保護は必要ありません。

ディスプレイミニポートドライバーは、情報をより最適に再作成できる場合、CDD が提供する情報を使用する必要はありません。たとえば、pRender->pPatchLocationListIn メンバーが空の場合、ユーザーモードのディスプレイドライバーが入力パッチの場所リストを提供していないため、ディスプレイミニポートドライバーは、代わりにコマンドバッファーの内容に基づいて、pRender->pPatchLocationListOut メンバーのコンテンツを生成できます。

DirectX グラフィックスカーネルサブシステムは、デバイス固有のハンドルに加えて、各割り当ての最後の既知の GPU セグメントアドレスを表示ミニポートドライバーを提供します。割り当てインデックス N が現在ページアウトされている場合、DirectX グラフィックスカーネルサブシステムは、DXGKARG_RENDER の pAllocationList メンバーの N番目の要素の SegmentId メンバーを 0 に設定します。 SegmentId 割り当てリストの N番目の要素のメンバーが 0 に設定されていない場合は、DirectX グラフィックスカーネルサブシステムが DMA バッファーを再パッチする DxgkDdiPatch 関数を呼び出す前に、指定されたセグメントアドレス情報を使用して生成された DMA バッファーにパッチを適用する必要があります。 DirectX グラフィックスカーネルサブシステムは、ドライバーが適切に修正プログラムを適用する必要がある DMA バッファーで DxgkDdiPatch 関数を呼び出さない可能性があるため、ドライバーは要求されたときにこの初期修正を実行する必要があります。

ドライバーの DxgkDdiRenderKm 関数は、前述のように初期 DMA バッファーの修正プログラムの適用を実行しますが、ドライバーは引き続き、DXGKARG_RENDER の pPatchLocationListOut メンバーが指定する出力パッチの場所の一覧に割り当てへのすべての参照を挿入する必要があります。 DMA バッファーが GPU に送信される前に割り当てのアドレスが変更される可能性があるため、このリストにはすべての参照が含まれている必要があります。したがって、DirectX グラフィックスカーネルサブシステムは、dma バッファーを再パッチする DxgkDdiPatch 関数を呼び出します。

割り当てをバインド解除するには、ディスプレイミニポートドライバーは、NULL ハンドルを参照する割り当てリスト内の要素を指定し、NULL 割り当てを参照する修正プログラムの場所要素 使用できます。通常、ドライバーは、NULL 要素として、割り当てリストの最初の要素 (要素 0) を使用する必要があります。

保証されたコントラクト DMA モードでは、ディスプレイミニポートドライバーが DMA バッファーにコマンドバッファーを変換するとき、CDD は変換コマンドのための十分なリソースを保証する必要があります。翻訳に十分なリソースが存在しない場合、ディスプレイミニポートドライバーは DMA バッファーを拒否する必要があります。詳細については、「保証されたコントラクト DMA バッファーモデルの使用」を参照してください。

DxgkDdiRenderKm をページング可能にする必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7
ターゲットプラットフォームの	デスクトップ
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース