PFND3D11DDI_DISPATCHINDIRECT コールバック関数 (d3d10umddi.h)
DispatchIndirect 関数は、コンピューティング シェーダーを実行します。
構文
PFND3D11DDI_DISPATCHINDIRECT Pfnd3d11ddiDispatchindirect;
void Pfnd3d11ddiDispatchindirect(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3
)
{...}
パラメーター
unnamedParam1
hDevice [in]
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
unnamedParam2
hBufferForArgs [in]
スレッド グループ グリッドの X、Y、Z ディメンションのサイズ (スレッド グループ) を保持する 3 つの UINT 値を含むバッファーへのハンドル。 バッファーには、次の密パック構造が含まれています。
struct DispatchArgs {
UINT ThreadGroupCountX;
UINT ThreadGroupCountY;
UINT ThreadGroupCountZ;
}
unnamedParam3
AlignedByteOffsetForArgs [in]
hBufferForArgs が指定するバッファーへのオフセット (バイト単位)。 AlignedByteOffsetForArgs は 4 の倍数である必要があります。
戻り値
なし
解説
ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。
DispatchIndirect 関数は、ドライバーの Dispatch 関数の呼び出しと同じタスクを実行します。 Direct3D ランタイムは、ディスプレイ デバイスでドライバーの DispatchIndirect 関数を呼び出して、スレッド グループのグリッド内の複数のスレッドに対してコンピューティング シェーダーを実行します。 ただし、 DispatchIndirect は 、hBufferForArgs パラメーターが指定するバッファーの内容から実行するスレッド グループの数を取得します。 DispatchIndirect は 、 AlignedByteOffsetForArgs パラメーターが指定するバイト オフセットから始まる 3 つの UINT 値を読み取ります。
Direct3D ランタイムがドライバーの CreateResource(D3D11) 関数を呼び出して hBufferForArgs パラメーターが指定するバッファー リソースを作成する場合、ランタイムは、D3D11DDIARG_CREATERESOURCE構造体の MiscFlags メンバーに D3D11_DDI_RESOURCE_MISC_DRAWINDIRECT_ARGS フラグを設定する必要があります。
ドライバーは、D3DDDIERR_DEVICEREMOVEDを除き、エラーが発生しないようにする必要があります。 したがって、ドライバーが pfnSetErrorCb 関数の呼び出しで、D3DDDIERR_DEVICEREMOVEDを除くエラーを渡した場合、Direct3D ランタイムはエラーが重大であると判断します。 デバイスが削除された場合でも、ドライバーはD3DDDIERR_DEVICEREMOVEDを返す必要はありません。ただし、デバイスの削除が DispatchIndirect の操作に干渉する場合 (通常は発生しないようにする必要があります)、ドライバーはD3DDDIERR_DEVICEREMOVEDを返すことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | DispatchIndirect は、Windows 7 オペレーティング システム以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |