ホーム › Graphics.DirectDraw › PDD_WAITFORVERTICALBLANK

PDD_WAITFORVERTICALBLANK

コールバック

シグネチャ

DWORD PDD_WAITFORVERTICALBLANK(
    DD_WAITFORVERTICALBLANKDATA* param0
);

パラメーター

フィールド	型	説明
param0	DD_WAITFORVERTICALBLANKDATA*	垂直帰線状態を取得するために必要な情報を格納した DD_WAITFORVERTICALBLANKDATA 構造体へのポインターです。

公式ドキュメント

DdWaitForVerticalBlank コールバック関数は、デバイスの垂直帰線状態を返します。

戻り値

DdWaitForVerticalBlank は、次のいずれかのコールバックコードを返します。

解説(Remarks)

lpWaitForVerticalBlank が指す DD_WAITFORVERTICALBLANKDATA 構造体の dwFlags メンバーの値に応じて、ドライバーは次の処理を行う必要があります。

dwFlags が DDWAITVB_I_TESTVB の場合、ドライバーは現在の垂直帰線状態を照会する必要があります。モニターが現在垂直帰線中であれば、ドライバーは DD_WAITFORVERTICALBLANKDATA の bIsInVB メンバーを TRUE に設定します。そうでない場合は bIsInVB を FALSE に設定します。
dwFlags が DDWAITVB_BLOCKBEGIN の場合、ドライバーはブロックして垂直帰線が開始されるまで待機する必要があります。ドライバーがブロックを開始した時点で垂直帰線が進行中の場合は、次の垂直帰線が開始されるまで待ってから戻る必要があります。
dwFlags が DDWAITVB_BLOCKEND の場合、ドライバーはブロックして垂直帰線が終了するまで待機する必要があります。

ドライバーが dwFlags で指定された動作を正常に処理した場合は、DD_WAITFORVERTICALBLANKDATA の ddRVal メンバーに DD_OK を設定し、DDHAL_DRIVER_HANDLED を返す必要があります。処理できないフラグについては、ドライバーは DDHAL_DRIVER_NOTHANDLED を返す必要があります。

DdWaitForVerticalBlank を使用すると、アプリケーションは垂直帰線期間 (VBI) と同期できます。

メモモニターの電源状態が原因でドライバーがハングするおそれがある場合、DdWaitForVerticalBlank は決してポーリングループに入ってはなりません。たとえば、モニターの電源切断中にアプリケーションが WaitForVerticalBlank を呼び出すことがあります。DirectDraw ランタイムはディスプレイドライバーの DdWaitForVerticalBlank エントリポイントを呼び出し、そこで状態が変化するのを待ちます。モニターの電源が切れている場合、ドライバー作成者がこの状況に備えていない限り、この値は決して変化しません。解決策の 1 つは、垂直帰線を待機するポーリングループにタイムアウトを設けることです。サンプルの Permedia2 ドライバーは、モニターの電源が切れている場合には単にポーリングを一切行わないようになっています。

WHQL ディスプレイ互換性テスト (DCT) にも問題があります。電源管理に関する DCT の 1 つは、モニターの電源を切ってから垂直帰線状態をポーリングし、それが変化するのを待ちます。モニターの電源が切れているときにドライバーが常に同じ垂直帰線状態を報告すると、テストアプリケーションは結果が変化するのを待ち続けてハングします。Permedia2 サンプルドライバーでは、モニターの電源が切れている間は交互の結果を返すようにしてこれを修正しました。つまり、(モニターの電源が切れているときに) ドライバーの DdWaitForVerticalBlank エントリポイントが DDWAIT_I_TESTVB フラグで最初に呼び出されたときは FALSE を返し、次は TRUE、その次は FALSE、というように返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)