Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::Present

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

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

パラメータ

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

戻り値

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

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

D3DERR_INVALIDCALL
D3DERR_DEVICELOST

注意

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

動作環境

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

参照

IDirect3DDevice8::Reset