Win32 API 日本語リファレンス
ホーム › Graphics.DirectDraw › PDD_VPORTCB_GETLINE

PDD_VPORTCB_GETLINE

コールバック

シグネチャ

DWORD PDD_VPORTCB_GETLINE(
    DD_GETVPORTLINEDATA* param0
);

パラメーター

フィールド型説明
param0DD_GETVPORTLINEDATA*指定されたハードウェアビデオポートの現在のライン番号をドライバーが判別して返すために必要な情報を格納した DD_GETVPORTLINEDATA 構造体を指します。

公式ドキュメント

DdVideoPortGetLine コールバック関数は、ハードウェアビデオポートの現在のライン番号を返します。

戻り値

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

解説(Remarks)

DDVIDEOPORTCAPS 構造体の dwCaps メンバーに DDVPCAPS_READBACKLINE フラグを設定するドライバーは、DdVideoPortGetLine を実装する必要があります。

ドライバーは、lpGetLine が指す DD_GETVPORTLINEDATA 構造体の dwLine メンバーに、現在のビデオラインの番号を書き込む必要があります。返すライン番号は 0 から始まる必要があります。つまり、ビデオの最初のラインがライン 0、2 番目のラインがライン 1、というようになります。

デバイスが垂直帰線期間中である場合、ドライバーは DD_GETVPORTLINEDATA の ddRVal メンバーに DDERR_VERTICALBLANKINPROGRESS を設定する必要があります。ハードウェアビデオポートが無効になっているためにクエリを実行できない場合、ドライバーは ddRVal に DDERR_VIDEONOTACTIVE を設定する必要があります。これらの失敗したケースのいずれにおいても、ドライバーは DDHAL_DRIVER_HANDLED を返す必要があります。

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