Microsoft DirectX 8.0 (C++)

IDirect3DSwapChain8::Present

スワップ チェーンが所有するバック バッファのシーケンスの中で次のコンテンツを提示する。

HRESULT Present(
  CONST RECT* pSourceRect,
  CONST RECT* pDestRect,
  HWND hDestWindowOverride,
  CONST RGNDATA* pDirtyRegion
);

パラメータ

pSourceRect
[in] 転送元矩形を含む RECT 構造体へのポインタ。この値は、スワップ チェーンが D3DSWAPEFFECT_COPY または D3DSWAPEFFECT_COPY_VSYNC で作成されていない限り、NULL でなければならない。NULL の場合は、転送元サーフェス全体が表示される。矩形が転送元サーフェスを超えた場合、矩形は転送元サーフェスにクリッピングされる。
pDestRect
[in] ウィンドウのクライアント座標で転送先矩形を含む RECT 構造体へのポインタ。この値は、スワップ チェーンが D3DSWAPEFFECT_COPY または D3DSWAPEFFECT_COPY_VSYNC で作成されていない限り、NULL でなければならない。NULL の場合は、クライアント領域全体が格納される。矩形が転送先のクライアント領域を越えた場合、矩形は転送先のクライアント領域にクリッピングされる。
hDestWindowOverride
[in] クライアント領域がこのプレゼンテーションの対象として扱われる転送先ウィンドウ。このパラメータが NULL の場合は、D3DPRESENT_PARAMETERShWndDeviceWindow メンバが使用される。
pDirtyRegion
[in] このパラメータは未使用なため、NULL に設定する必要がある。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

注意

このメソッドの動作は、IDirect3DDevice8::Present メソッドとまったく同じである。

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

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::Reset