PFND3D10DDI_SETRENDERTARGETS コールバック関数 (d3d10umddi.h)
SetRenderTargets コールバック関数セットは、レンダー ターゲット サーフェスを設定します。
構文
PFND3D10DDI_SETRENDERTARGETS Pfnd3d10ddiSetrendertargets;
void Pfnd3d10ddiSetrendertargets(
[in] D3D10DDI_HDEVICE unnamedParam1,
[in] const D3D10DDI_HRENDERTARGETVIEW *unnamedParam2,
[in] UINT NumViews,
[in] UINT ClearSlots,
[in] D3D10DDI_HDEPTHSTENCILVIEW unnamedParam5
)
{...}
パラメーター
[in] unnamedParam1
hDevice: ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。
[in] unnamedParam2
phRenderTargetView: 設定するレンダー ターゲット ビュー オブジェクトへのハンドルの配列。 一部のハンドル値には NULL を指定できます。
[in] NumViews
: phRenderTargetView が指定する配列内の要素の数。
[in] ClearSlots
NumViews が NULL に設定するように指定したスロットの数の後のレンダー ターゲット スロットの数。 この数値は、以前のレンダー ターゲット ビュー オブジェクトの数 (つまり、Microsoft Direct3D ランタイムが以前 に SetRenderTargets と呼んだ場合) と、新しい数のレンダー ターゲット ビュー オブジェクトの差を表します。
ClearTargets が指定する数値は、ユーザー モードのディスプレイ ドライバーがこの数値を計算できるため、最適化に役立ちます。
[in] unnamedParam5
hDepthStencilView: 深度ステンシル ビューへのハンドル。
戻り値
なし
解説
ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。
ユーザー モード ディスプレイ ドライバーは、すべてのレンダー ターゲット サーフェスと深度ステンシル バッファーを 1 つの操作としてアトミックに設定する必要があります。
NumViews パラメーターは、phRenderTargetView パラメーターが指定する配列内のハンドルの数を指定しますが、配列内の一部のハンドル値は NULL にすることができます。
NumViews が指定する数と、すべての NULL 値または非連結値を含めるために必要なレンダー ターゲット サーフェスの最大数との間のレンダー ターゲット サーフェスの範囲。 ClearTargets パラメーターが指定する数値は、現在のアトミック操作でドライバーがクリアする必要があるバインド ポイントの数をドライバーに通知します。
以前の SetRenderTargets の呼び出しで NumViews パラメーターに値 2 が渡され、SetRenderTargets の現在の呼び出しで NumViews で値 4 が渡された場合、SetRenderTargets の現在の呼び出しでは ClearTargets パラメーターの値 0 も渡されます。 SetRenderTargets への次の連続する呼び出しが NumViews で 1 の値を渡した場合、連続する呼び出しでは ClearTargets で値 3 (4 - 1) も渡されます。
ユーザー モードのクエリ操作中にクリア ターゲットの値が要求された場合、値はレンダー ターゲット サーフェスの最大数とレンダー ターゲットの値の差です。
ドライバーは、D3DDDIERR_DEVICEREMOVEDを除き、エラーが発生しないようにする必要があります。 したがって、ドライバーが pfnSetErrorCb 関数の呼び出しで、D3DDDIERR_DEVICEREMOVEDを除くエラーを渡した場合、Microsoft Direct3D ランタイムはエラーが重大であると判断します。 デバイスが削除された場合でも、ドライバーはD3DDDIERR_DEVICEREMOVEDを返す必要はありません。ただし、デバイスの削除が SetRenderTargets の操作に干渉した場合 (通常は発生しないはずです)、ドライバーはD3DDDIERR_DEVICEREMOVEDを返すことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |