Share via

PDD_VPORTCB_GETOUTPUTFORMATS回调函数 (ddrawint.h)

  • 项目

DdVideoPortGetOutputFormats 回调函数确定 VPE 对象支持的输出格式。

语法

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

参数

unnamedParam1

指向 DD_GETVPORTOUTPUTFORMATDATA 结构，该结构包含驱动程序返回 VPE 对象支持的输出格式所需的信息。

返回值

DdVideoPortGetOutputFormats 返回以下回调代码之一：

备注

支持 VPE 的 DirectDraw 驱动程序必须实现 DdVideoPortGetOutputFormats

DirectDraw 调用 DdVideoPortGetOutputFormats 以获取指定的 VPE 对象支持的输出格式数和每种格式的说明。 为指定的 VPE 对象调用两次 DdVideoPortGetOutputFormats：

  • 在第一次调用中， lpGetOutputFormats 处DD_GETVPORTOUTPUTFORMATDATA结构的 lpddpfOutputFormats 成员为 NULL。 驱动程序应在 DD_GETVPORTOUTPUTFORMATDATA 的 dwNumFormats 成员中写入 VPE 对象支持的输出格式数。 返回后，DirectDraw 将分配此数量的 DDPIXELFORMAT 结构，以传入对 DdVideoPortGetOutputFormats 的第二次调用。
  • 第二次调用中， lpddpfOutputFormats 指向分配的 DDPIXELFORMAT 结构的数组。 驱动程序应在每个结构中填充 VPE 对象可以写入帧缓冲区的每个输出格式的说明。 驱动程序应仅根据视频数据的输入格式返回它支持的那些输出格式。 驱动程序还应返回 dwNumFormats 中支持的输出格式数。 请注意，驱动程序可以保证 lpddpfOutputFormats 指向的缓冲区足够大，足以保存所请求的格式信息。
如果 DD_GETVPORTOUTPUTFORMATDATA 的 dwFlags 成员仅设置为DDVPFORMAT_VIDEO，则驱动程序应仅返回正常视频数据支持的那些输出格式。 如果 dwFlags 仅设置为 DDVPFORMAT_VBI，则驱动程序应仅返回 VBI 数据支持的那些格式。 如果将 dwFlags 设置为这两个标志，驱动程序应返回 VPE 对象支持的所有格式。

要求

   
目标平台 桌面
标头 ddrawint.h (包括 Winddi.h)

请参阅

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA