Platform SDK: DirectX

DirectDrawSurface7.Flip

DirectDrawSurface7.Flip メソッドは、DDSCAPS_BACKBUFFER サーフェスと関連付けられたサーフェス メモリを、フロント バッファ サーフェスと関連付ける。

object.Flip( _ 
    ddS As DirectDrawSurface7, _ 
    flags As CONST_DDFLIPFLAGS)

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
ddS
フリッピング チェーン内の任意のサーフェスに対する DirectDrawSurface7 オブジェクト。このパラメータのデフォルトは Nothing であり、この場合、DirectDraw は互いにアタッチされている順にバッファから循環する。このパラメータが Nothing でない場合、DirectDraw はフリッピング チェーンの次のサーフェスの代わりに指定したサーフェスへフリップする。指定したサーフェスがフリッピング チェーンのメンバではない場合、メソッドは失敗する。
flags
フリップ オプションを指定する CONST_DDFLIPFLAGS 列挙の 1 つまたは複数の定数。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOFLIPHW
DDERR_NOTFLIPPABLE
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

注意

このメソッドを呼び出すことができるのは、DDSCAPS_FLIP および DDSCAPS_FRONTBUFFER 能力のあるサーフェスだけである。このメソッドを呼び出す以前にフロント バッファと関連付けられたディスプレイ メモリは、バック バッファと関連付けられる。

ddS パラメータは、バック バッファがフロント バッファになるべきバッファではないというまれな場合に使用される。通常、このパラメータは Nothing である。

DirectDrawSurface7.Flip メソッドは、常に垂直線消去と同期する。サーフェスがビデオ ポートに割り当てられていると、このメソッドは表示されるオーバーレイ サーフェスとビデオ ポートのターゲット サーフェスを更新する。

詳細については、「フリッピング サーフェス」を参照すること。

参照

DirectDrawSurface7.GetFlipStatus