PFND3D11DDI_CREATECOMMANDLIST コールバック関数 (d3d10umddi.h)

[アーティクル]
08/07/2023

CreateCommandList 関数は、コマンドリストを作成します。

構文

PFND3D11DDI_CREATECOMMANDLIST Pfnd3d11ddiCreatecommandlist;

void Pfnd3d11ddiCreatecommandlist(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATECOMMANDLIST *unnamedParam2,
  D3D11DDI_HCOMMANDLIST unnamedParam3,
  D3D11DDI_HRTCOMMANDLIST unnamedParam4
)
{...}

パラメーター

unnamedParam1

hDevice [in]

ディスプレイデバイスへのハンドル (グラフィックスコンテキスト)。

unnamedParam2

pCreateCommandList [in]

ユーザーモードディスプレイドライバーがコマンドリストの作成に使用するパラメーターを記述するD3D11DDIARG_CREATECOMMANDLIST構造体へのポインター。

unnamedParam3

hCommandList [in]

コマンドリストのドライバーのプライベートデータへのハンドル。

unnamedParam4

hRTCommandList [in]

ドライバーが Direct3D ランタイムに呼び出すときに使用するコマンドリストのハンドル。

戻り値

なし

解説

ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラーコードを設定できます。

ドライバーは、ドライバーが GetCaps(D3D10_2) 関数の呼び出しからD3D11DDI_THREADING_CAPS構造体で返すことができるD3D11DDICAPS_COMMANDLISTS_BUILD_2機能をサポートしている場合にのみ、CreateCommandList を実装するために必要です。

ドライバーは、E_OUTOFMEMORY (ドライバーがメモリ不足の場合) または D3DDDIERR_DEVICEREMOVED (デバイスが削除された場合) を pfnSetErrorCb 関数の呼び出しで渡すことができます。 Direct3D ランタイムは、他のエラーが重大であると判断します。ドライバーがエラー (D3DDDIERR_DEVICEREMOVEDを含む) を渡すと、Direct3D ランタイムはハンドルが無効であると判断します。したがって、ランタイムは、 hCommandList パラメーターが指定するハンドルを破棄するために DestroyCommandList 関数を呼び出しません。

要件

要件	値
サポートされている最小のクライアント	CreateCommandList は、Windows 7 オペレーティングシステム以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	d3d10umddi.h (D3d10umddi.h を含む)