Share via

PDD_VPORTCB_GETINPUTFORMATS回调函数 (ddrawint.h)

  • 项目

DdVideoPortGetInputFormats 回调函数确定 DirectDraw VPE 对象可以接受的输入格式。

语法

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

参数

unnamedParam1

指向 DD_GETVPORTINPUTFORMATDATA 结构，该结构包含驱动程序返回 VPE 对象可以接受的输入格式所需的信息。

返回值

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

备注

DdVideoPortGetInputFormats 必须在支持 VPE 的 DirectDraw 驱动程序中实现。

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

  • 在第一次调用中，lpGetInputFormats DD_GETVPORTINPUTFORMATDATA 结构的 lpddpfFormat 成员为 NULL。 驱动程序应在 DD_GETVPORTINPUTFORMATDATA 的 dwNumFormats 成员中写入 VPE 对象支持的输入格式数。 返回后，DirectDraw 将分配此数量的 DDPIXELFORMAT 结构，以在对 DdVideoPortGetInputFormats 的第二次调用中传递。
  • 第二次调用中， lpddpfFormat 指向已分配的 DDPIXELFORMAT 结构的数组。 驱动程序应填充每个结构，以描述 VPE 对象支持的每个输入格式。 驱动程序还应返回 dwNumFormats 中支持的输入格式的数目。 请注意，驱动程序保证 lpddpfFormat 指向的缓冲区足够大，足以保存所请求的格式信息。
如果 DD_GETVPORTINPUTFORMATDATA 结构的 dwFlags 成员仅设置为 DDVPFORMAT_VIDEO，则驱动程序应仅返回正常视频数据支持的格式。 如果 dwFlags 仅设置为 DDVPFORMAT_VBI，则驱动程序应仅返回 VBI 数据支持的格式。 如果将 dwFlags 设置为这两个标志，驱动程序应返回 VPE 对象支持的所有格式。

要求

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

另请参阅

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA