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

  • [アーティクル]

DdVideoPortGetInputFormats コールバック関数は、DirectDraw VPE オブジェクトが受け入れ可能な入力形式を決定します。

構文

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

パラメーター

unnamedParam1

ドライバー が VPE オブジェクトで受け入れられる入力形式を返すために必要な情報を含むDD_GETVPORTINPUTFORMATDATA構造体を指します。

戻り値

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

解説

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

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

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

要件

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

関連項目

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA