SwapChain.Present メソッド (Rectangle, Rectangle, Control)

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

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

スワップチェーンが所有するバックバッファーのシーケンスの中の次のバッファーの内容を表示します。

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

構文

'宣言
Public Sub Present ( _
    sourceRectangle As Rectangle, _
    destRectangle As Rectangle, _
    overrideWindow As Control _
)
'使用
Dim instance As SwapChain
Dim sourceRectangle As Rectangle
Dim destRectangle As Rectangle
Dim overrideWindow As Control

instance.Present(sourceRectangle, destRectangle, _
    overrideWindow)

public void Present(
    Rectangle sourceRectangle,
    Rectangle destRectangle,
    Control overrideWindow
)

public:
void Present(
    Rectangle sourceRectangle, 
    Rectangle destRectangle, 
    Control^ overrideWindow
)

member Present : 
        sourceRectangle:Rectangle * 
        destRectangle:Rectangle * 
        overrideWindow:Control -> unit

パラメーター

sourceRectangle
型 : System.Drawing.Rectangle
Rectangle が rectPresent パラメーターに渡される場合は true、それ以外の場合は、false に設定します。

destRectangle
型 : System.Drawing.Rectangle
ウィンドウのクライアント座標内の転送先四角形を格納する Rectangle。この値は、スワップチェーンが Copy の SwapEffect で作成されていない限り、省略する必要があります。この値が省略された場合、転送元サーフェイス全体が表示されます。四角形が転送元サーフェイスを越える場合は、転送元サーフェイスに合わせてクリッピングされます。

overrideWindow
型 : System.Windows.Forms.Control
クライアント領域が現在のプレゼンテーションの転送先として扱われる転送先ウィンドウ。

例外

例外	条件
DriverInternalErrorException	ドライバーの内部エラー。このエラーを受け取った場合、通常、アプリケーションをシャットダウンする必要があります。
InvalidCallException	メソッドの呼び出しが無効です。たとえば、メソッドのパラメーターに無効な値が含まれている場合などです。
OutOfMemoryException	Direct3D で、呼び出しを完了するために十分なメモリを割り当てられませんでした。

解説

このメソッドは、Present の Device へのショートカットです。スワップチェーンメソッドが更新され、アプリケーションが、ドライバーがプレゼンテーションをスケジュールできないと報告したときにメソッドからすぐに制御が戻るように要求できるようにするフラグが追加されました。

必要に応じて、転送元四角形内のピクセルを転送先ウィンドウのクライアント領域内の転送先四角形に転送するために、拡大処理が適用されます。

レンダリングターゲットが現在のレンダリングターゲットでない場合 (追加のスワップチェーンを作成する際に取得したバックバッファーなど) を除き、Present の Device メソッドは、BeginScene と EndScene のペアの間で呼び出されると失敗します。

.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

参照

SwapChain クラス

SwapChain メンバー

Present オーバーロード

Microsoft.WindowsMobile.DirectX.Direct3D 名前空間

次の方法で共有