PDD_VPORTCB_GETOUTPUTFORMATS

DWORD PDD_VPORTCB_GETOUTPUTFORMATS(
    DD_GETVPORTOUTPUTFORMATDATA* param0
);

DdVideoPortGetOutputFormats コールバック関数は、VPE オブジェクトがサポートする出力フォーマットを判別します。

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

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

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

• 1 回目の呼び出しでは、lpGetOutputFormats が指す DD_GETVPORTOUTPUTFORMATDATA 構造体の lpddpfOutputFormats メンバーは NULL です。ドライバーは、VPE オブジェクトがサポートする出力フォーマットの数を DD_GETVPORTOUTPUTFORMATDATA の dwNumFormats メンバーに書き込む必要があります。制御が戻ると、DirectDraw は DdVideoPortGetOutputFormats の 2 回目の呼び出しで渡すために、その数だけの DDPIXELFORMAT 構造体を割り当てます。
• 2 回目の呼び出しでは、lpddpfOutputFormats は割り当てられた DDPIXELFORMAT 構造体の配列を指します。ドライバーは、VPE オブジェクトがフレームバッファーに書き込める各出力フォーマットの説明を各構造体に設定する必要があります。ドライバーは、ビデオデータの入力フォーマットに基づいて、自身がサポートする出力フォーマットのみを返す必要があります。また、サポートする出力フォーマットの数を dwNumFormats に返す必要があります。なお、lpddpfOutputFormats が指すバッファーは、要求されるフォーマット情報を格納するのに十分な大きさであることが保証されています。

DD_GETVPORTOUTPUTFORMATDATA の dwFlags メンバーに DDVPFORMAT_VIDEO のみが設定されている場合、ドライバーは通常のビデオデータに対してサポートされる出力フォーマットのみを返す必要があります。dwFlags に DDVPFORMAT_VBI のみが設定されている場合、ドライバーは VBI データに対してサポートされるフォーマットのみを返す必要があります。両方のフラグが設定されている場合、ドライバーは VPE オブジェクトがサポートするすべてのフォーマットを返す必要があります。