PDD_VPORTCB_GETOUTPUTFORMATS コールバック関数 (ddrawint.h)

  • [アーティクル]

DdVideoPortGetOutputFormats コールバック関数は、VPE オブジェクトがサポートする出力形式を決定します。

構文

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

パラメーター

unnamedParam1

ドライバー が VPE オブジェクトでサポートされている出力形式を返すために必要な情報を含むDD_GETVPORTOUTPUTFORMATDATA構造体を指します。

戻り値

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

解説

VPE をサポートする DirectDraw ドライバーは、DdVideoPortGetOutputFormats を実装する必要があります

DirectDraw は DdVideoPortGetOutputFormats を呼び出して、指定された VPE オブジェクトでサポートされる出力形式の数と各形式の説明を取得します。 DdVideoPortGetOutputFormats は、指定された VPE オブジェクトに対して 2 回呼び出されます。

  • 最初の呼び出しでは、lpGetOutputFormats のDD_GETVPORTOUTPUTFORMATDATA構造体の lpddpfOutputFormats メンバーは NULL です。 ドライバーは、VPE オブジェクトがサポートする出力形式の数を、DD_GETVPORTOUTPUTFORMATDATAの dwNumFormats メンバーに書き込む必要があります。 DirectDraw は、戻り時にこの数の DDPIXELFORMAT 構造体を割り当てて 、DdVideoPortGetOutputFormats への 2 番目の呼び出しを渡します。
  • 2 番目の呼び出しでは、 lpddpfOutputFormats は割り当てられた DDPIXELFORMAT 構造体の配列を指します。 ドライバーは、VPE オブジェクトがフレーム バッファーに書き込むことができる各出力形式の説明を各構造体に入力する必要があります。 ドライバーは、ビデオ データの入力形式に基づいてサポートされている出力形式のみを返す必要があります。 ドライバーは 、dwNumFormats でサポートされている出力形式の数も返す必要があります。 ドライバーは、 lpddpfOutputFormats ポイント先のバッファーが、要求されている形式情報を保持するのに十分な大きさであることが保証されることに注意してください。
DD_GETVPORTOUTPUTFORMATDATA の dwFlags メンバーが DDVPFORMAT_VIDEO のみに設定されている場合、ドライバーは、通常のビデオ データでサポートされている出力形式のみを返す必要があります。 dwFlags が DDVPFORMAT_VBI のみに設定されている場合、ドライバーは VBI データでサポートされている形式のみを返す必要があります。 dwFlags が両方のフラグに設定されている場合、ドライバーは VPE オブジェクトでサポートされているすべての形式を返す必要があります。

要件

   
対象プラットフォーム デスクトップ
Header ddrawint.h (Winddi.h を含む)

関連項目

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA