Platform SDK: DirectX

IDirectDrawVideoPort::WaitForSync

IDirectDrawVideoPort::WaitForSync メソッドは、VSYNC、または与えられた走査線を描くまで待機する。

HRESULT WaitForSync(
  DWORD dwFlags,  
  DWORD dwLine,   
  DWORD dwTimeout 
);

パラメータ

dwFlags
メソッドがビデオ VSYNC または指定されたライン番号をどのように待機するかを指定するフラグ。以下のフラグのうち、いずれかの値を取る。
DDVPWAIT_BEGIN
垂直帰線消去間隔の開始時に返す。
DDVPWAIT_END
垂直帰線消去間隔の終了時に返す。
DDVPWAIT_LINE
ビデオ カウンタが、dwLine パラメータで指定されたラインに達するか超えるときに返す。
dwLine
プレスケーリングの前に、フィールドの高さを基準にしていつメソッドが返るかを決定するビデオ ライン。dwFlags パラメータが DDVPWAIT_BEGIN または DDVPWAIT_END に設定されている場合、このパラメータは無視される。
dwTimeout
タイムアウトするまでに、メソッドが次のビデオ垂直帰線消去を待機する時間 (ミリ秒)。このパラメータが 0 の場合、メソッドは DDVIDEOPORTDESCdwMicrosecondsPerField メンバに指定された値の 3 倍の時間待機する。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_UNSUPPORTED
DDERR_VIDEONOTACTIVE
DDERR_WASSTILLDRAWING

注意

このメソッドは、呼び出し側が垂直帰線消去間隔、またはビデオ データの任意のラインと同期するのを手伝う。このメソッドは、ビデオ VSYNC が発生するか、またはビデオ ライン カウンタが指定のライン番号に一致するまでスレッドの呼び出しをブロックする。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dvp.h で宣言。
  インポート ライブラリ : ddraw.lib を使用。