Microsoft DirectX 8.0 (Visual Basic) |
デバイスに新しいカラー バッファと深度バッファの一方または両方を設定する。
object.SetRenderTarget( _ NewRenderTarget As Direct3DSurface8, _ NewDepthStencil As Direct3DSurface8)
新しいレンダリング ターゲットのサーフェスには、少なくとも D3DUSAGE_RENDERTARGET が指定されていなければならない。
新しい深度ステンシル サーフェスには、少なくとも D3DUSAGE_DEPTHSTENCIL と D3DPOOL_DEFAULT が指定されていなければならない。
失敗した場合はエラーが発生し、NewRenderTarget または NewDepthStencil が Nothing ではない無効な値の場合、あるいは新しい深度バッファが新しいカラー バッファまたは引き続き使われるカラー バッファより小さい場合は、Err.Number に D3DERR_INVALIDCALL が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
このメソッドを使ってカラー バッファと深度ステンシル サーフェスを同じデバイスに関連付けると、両者はペアになる。
SetRenderTarget を呼び出して以前の深度ステンシル サーフェスとデバイスの関連を切断した後でも、前の深度ステンシル サーフェスのコンテンツは保持される。そのサーフェスをデバイスと再び関連付けると、新しい深度ステンシル サーフェスとペアにされているカラー バッファのサイズとフォーマットが、深度ステンシル サーフェスと最後にペアになっていたカラー バッファと同じならば、サーフェスのコンテンツは変更されない。
Direct3DDevice8.CreateDepthStencilSurface、Direct3DDevice8.GetDepthStencilSurface