PDD_VPORTCB_GETINPUTFORMATS

DWORD PDD_VPORTCB_GETINPUTFORMATS(
    DD_GETVPORTINPUTFORMATDATA* param0
);

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

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

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

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

• 1 回目の呼び出しでは、lpGetInputFormats が指す DD_GETVPORTINPUTFORMATDATA 構造体の lpddpfFormat メンバーは NULL です。ドライバーは、VPE オブジェクトがサポートする入力形式の数を DD_GETVPORTINPUTFORMATDATA の dwNumFormats メンバーに書き込む必要があります。復帰後、DirectDraw はこの数の DDPIXELFORMAT 構造体を割り当て、2 回目の DdVideoPortGetInputFormats の呼び出しで渡します。
• 2 回目の呼び出しでは、lpddpfFormat は割り当てられた DDPIXELFORMAT 構造体の配列を指します。ドライバーは、VPE オブジェクトがサポートする各入力形式を記述するように各構造体を設定する必要があります。また、ドライバーはサポートする入力形式の数を dwNumFormats に返す必要があります。なお、lpddpfFormat が指すバッファーは、要求された形式情報を格納するのに十分な大きさであることが保証されています。

DD_GETVPORTINPUTFORMATDATA 構造体の dwFlags メンバーに DDVPFORMAT_VIDEO のみが設定されている場合、ドライバーは通常のビデオデータでサポートされる形式のみを返す必要があります。dwFlags に DDVPFORMAT_VBI のみが設定されている場合、ドライバーは VBI データでサポートされる形式のみを返す必要があります。dwFlags に両方のフラグが設定されている場合、ドライバーは VPE オブジェクトがサポートするすべての形式を返す必要があります。