Device.CreateRenderTarget メソッド

[アーティクル]
11/03/2009

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。空白のトピックは、プレースホルダーとして挿入されています。]

レンダリング先のサーフェイスを作成します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)

構文

'宣言
Public Function CreateRenderTarget ( _
    width As Integer, _
    height As Integer, _
    format As Format, _
    multiSampleType As MultiSampleType, _
    lockable As Boolean _
) As Surface
'使用
Dim instance As Device
Dim width As Integer
Dim height As Integer
Dim format As Format
Dim multiSampleType As MultiSampleType
Dim lockable As Boolean
Dim returnValue As Surface

returnValue = instance.CreateRenderTarget(width, _
    height, format, multiSampleType, _
    lockable)

public Surface CreateRenderTarget(
    int width,
    int height,
    Format format,
    MultiSampleType multiSampleType,
    bool lockable
)

public:
Surface^ CreateRenderTarget(
    int width, 
    int height, 
    Format format, 
    MultiSampleType multiSampleType, 
    bool lockable
)

member CreateRenderTarget : 
        width:int * 
        height:int * 
        format:Format * 
        multiSampleType:MultiSampleType * 
        lockable:bool -> Surface

パラメーター

width
型 : System.Int32
レンダリング先のサーフェイスの幅 (ピクセル単位)。

height
型 : System.Int32
レンダリング先のサーフェイスの高さ (ピクセル単位)。

format
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Format
レンダリング先の形式を記述する、Format 列挙型のメンバー。

multiSampleType
型 : Microsoft.WindowsMobile.DirectX.Direct3D.MultiSampleType
マルチサンプリングバッファータイプを記述する MultiSampleType 列挙型のメンバー。このパラメーターは、レンダリング先のアンチエイリアスタイプを指定します。このサーフェイスを SetRenderTarget に渡す場合は、サーフェイスのマルチサンプルタイプが深度ステンシルプロパティ DepthStencilSurface のマルチサンプルタイプと同じである必要があります。

lockable
型 : System.Boolean
レンダリング先がロック可能な場合は true に設定します。それ以外の場合は、false に設定します。一部のグラフィックスハードウェアでは、ロック可能なレンダリング先によってパフォーマンスが低下します。

戻り値

型 : Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Surface 。

例外

例外	条件
NotAvailableException	デバイスは、照会されたマルチサンプルタイプをサポートしていません。
InvalidCallException	メソッドの呼び出しが無効です。たとえば、パラメーターに無効な値が含まれている場合などです。
OutOfMemoryException	Direct3D は、呼び出しを完了するためのメモリが不足しています。

解説

レンダリング先は、レンダリングサーフェイスです。たとえば、ピクセル単位のシーンデータ (色など) をレンダリング先のサーフェイスに書き込む 3-D レンダラーなどです。

レンダリング先のサーフェイスは、Pool メモリクラスに格納されます。ロック可能なマルチサンプルレンダリング先の作成はサポートされていません。

.NET Framework セキュリティ

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

プラットフォーム

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

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。

バージョン情報

.NET Compact Framework

サポート対象 : 3.5、2.0

参照

Device クラス

Device メンバー

Microsoft.WindowsMobile.DirectX.Direct3D 名前空間

次の方法で共有