IDirect3DDevice9Ex::CreateRenderTargetEx メソッド (d3d9.h)
レンダー ターゲット サーフェスを作成します。
構文
HRESULT CreateRenderTargetEx(
[in] UINT Width,
[in] UINT Height,
[in] D3DFORMAT Format,
[in] D3DMULTISAMPLE_TYPE MultiSample,
[in] DWORD MultisampleQuality,
[in] BOOL Lockable,
[out, retval] IDirect3DSurface9 **ppSurface,
[in] HANDLE *pSharedHandle,
[in] DWORD Usage
);
パラメーター
[in] Width
型: UINT
レンダー ターゲット サーフェスの幅 (ピクセル単位)。
[in] Height
型: UINT
レンダー ターゲット サーフェスの高さ (ピクセル単位)。
[in] Format
種類: D3DFORMAT
レンダー ターゲットの形式を記述する、 D3DFORMAT 列挙型のメンバー。
[in] MultiSample
マルチサンプリング バッファー型を記述する、 D3DMULTISAMPLE_TYPE 列挙型のメンバー。 このパラメーターは、このレンダー ターゲットのアンチエイリアシングの種類を指定します。 このサーフェスを IDirect3DDevice9::SetRenderTarget に渡す場合、そのマルチサンプルの種類は 、IDirect3DDevice9::SetDepthStencilSurface によって設定された深度ステンシルの型と同じである必要があります。
[in] MultisampleQuality
型: DWORD
品質レベル。 有効な範囲は、 IDirect3D9::CheckDeviceMultiSampleType によって使用される pQualityLevels によって返されるレベルより 0 から 1 未満の範囲です。 より大きな値を渡すと、エラーが返D3DERR_INVALIDCALL。 ペアのレンダー ターゲット、深度ステンシル サーフェス、マルチサンプルタイプの MultisampleQuality 値はすべて一致している必要があります。
[in] Lockable
種類: BOOL
アプリケーションで Lockable に TRUE を 指定しない限り、レンダー ターゲットはロックできません。
ロック可能なレンダー ターゲットでは、一部のグラフィックス ハードウェアのパフォーマンスが低下します。 読み取り戻しのパフォーマンス (ビデオ メモリからシステム メモリへのデータの移動) は、使用されるハードウェアの種類 (AGP と PCI Express) によって異なり、通常はアップロード パフォーマンス (システムからビデオ メモリへのデータの移動) よりもはるかに低くなります。 レンダー ターゲットに読み取りアクセスが必要な場合は、ロック可能なレンダー ターゲットの代わりに GetRenderTargetData を 使用します。
[out, retval] ppSurface
種類: IDirect3DSurface9**
IDirect3DSurface9 インターフェイスへのポインターのアドレス。
[in] pSharedHandle
型: HANDLE*
予約済み。 このパラメーターを NULL に設定 します。 このパラメーターは、Windows Vista 用 Direct3D 9 で リソースを共有するために使用できます。
[in] Usage
型: DWORD
1 つ以上の D3DUSAGE 定数を組み合わせて使用します。これは、OR を組み合わせて使用できます。 値 0 は使用量がないことを示します。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。
注釈
レンダー ターゲット サーフェスは、D3DPOOL_DEFAULT メモリ クラスに配置されます。
ロック可能なマルチサンプリング レンダー ターゲットの作成はサポートされていません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h |
| Library | D3D9.lib |