Device.SetRenderTarget メソッド

.NET Framework クラス ライブラリ リファレンス

Device.SetRenderTarget メソッド

デバイスの新しいカラー バッファを設定します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文

Visual Basic (宣言)

Public Sub SetRenderTarget ( _
    renderTarget As Surface, _
    newZStencil As Surface _
)

Visual Basic (使用法)

Dim instance As Device
Dim renderTarget As Surface
Dim newZStencil As Surface

instance.SetRenderTarget(renderTarget, newZStencil)

C#

public void SetRenderTarget (
    Surface renderTarget,
    Surface newZStencil
)

C++

public:
void SetRenderTarget (
    Surface^ renderTarget, 
    Surface^ newZStencil
)

J#

public void SetRenderTarget (
    Surface renderTarget, 
    Surface newZStencil
)

JScript

public function SetRenderTarget (
    renderTarget : Surface, 
    newZStencil : Surface
)

パラメータ

renderTarget

レンダリング先の Surface インデックス。

newZStencil

新しいカラー バッファ Surface。null 参照 (Visual Basic では Nothing) に設定すると、対応する renderTarget のカラー バッファが無効になります。デバイスには、常にカラー バッファが関連付けられている必要があります。

新しいレンダリング先のサーフェイスには、少なくとも Usage が指定されている必要があります。

例外

例外の種類	条件
InvalidCallException	メソッドの呼び出しが無効です。renderTarget が null 参照 (Visual Basic では Nothing) で newZStencil が 0 か、または renderTarget が null 参照 (Visual Basic では Nothing) でなくレンダリング先が無効です。

解説

デバイスは複数のレンダリング先をサポートできます。一部のハードウェアは、深度ステンシル バッファとカラー バッファの互換性をテストします。テストが行われる場合は、デバッグ ビルドでのみ行われます。このメソッドを使用するときは、次の制限が適用されます。

• レンダリング先と深度ステンシル サーフェイスの MultiSampleType は、同一である必要があります。

• レンダリング先の形式と深度ステンシル サーフェイスの形式には、互換性が必要です。詳細については、「CheckDepthStencilMatch」を参照してください。

• 深度ステンシル サーフェイスのサイズは、レンダリング先のサイズ以上である必要があります。

これらの制限は、デバッグ ランタイム使用時に Device のいずれかの描画メソッドが呼び出された場合にのみ確認されます。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Device クラス
Device メンバ
Microsoft.WindowsMobile.DirectX.Direct3D 名前空間