SwapChain.Present メソッド (Rectangle, Boolean)
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
スワップ チェーンが所有するバック バッファーのシーケンスの中の次のバッファーの内容を表示します。
名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)
構文
'宣言
Public Sub Present ( _
rectPresent As Rectangle, _
sourceRectangle As Boolean _
)
'使用
Dim instance As SwapChain
Dim rectPresent As Rectangle
Dim sourceRectangle As Boolean
instance.Present(rectPresent, sourceRectangle)
public void Present(
Rectangle rectPresent,
bool sourceRectangle
)
public:
void Present(
Rectangle rectPresent,
bool sourceRectangle
)
member Present :
rectPresent:Rectangle *
sourceRectangle:bool -> unit
パラメーター
- rectPresent
型 : System.Drawing.Rectangle
転送元四角形を格納する Rectangle 構造体。この値は、スワップ チェーンが Copy の SwapEffect で作成されていない限り、省略する必要があります。この値が省略された場合、転送元サーフェイス全体が表示されます。四角形が転送元サーフェイスを越える場合は、転送元サーフェイスに合わせてクリッピングされます。
- sourceRectangle
型 : System.Boolean
Rectangle が rectPresent パラメーターに渡される場合は true、それ以外の場合は、false に設定します。
例外
| 例外 | 条件 |
|---|---|
| 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