IDirect3DDevice9::GetRenderTargetData メソッド (d3d9.h)
レンダー ターゲット データをデバイス メモリからシステム メモリにコピーします。
構文
HRESULT GetRenderTargetData(
[in] IDirect3DSurface9 *pRenderTarget,
[in] IDirect3DSurface9 *pDestSurface
);
パラメーター
[in] pRenderTarget
種類: IDirect3DSurface9*
レンダー ターゲットを表す IDirect3DSurface9 オブジェクトへのポインター。
[in] pDestSurface
種類: IDirect3DSurface9*
宛先サーフェスを表す IDirect3DSurface9 オブジェクトへのポインター。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL。
注釈
変換先のサーフェスは、画面外のプレーン サーフェスであるか、D3DPOOL_SYSTEMMEMで作成されたテクスチャ (ミップマップまたはキューブ テクスチャ) のレベルである必要があります。
ソース サーフェスは、通常のレンダー ターゲットであるか、POOL_DEFAULTで作成されたレンダー ターゲット テクスチャ (ミップマップまたはキューブ テクスチャ) のレベルである必要があります。
このメソッドは、次の場合に失敗します。
- レンダー ターゲットはマルチサンプリングされます。
- ソース レンダー ターゲットのサイズは、ターゲット サーフェスとは異なります。
- ソース レンダー ターゲットとターゲット サーフェスの形式が一致しません。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | d3d9.h (D3D9.h を含む) |
Library | D3D9.lib |