PDD_VPORTCB_GETVPORTCONNECT回调函数 (ddrawint.h)
DdVideoPortGetConnectInfo 回调函数返回指定的 VPE 对象支持的连接。
语法
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
参数
unnamedParam1
指向 DD_GETVPORTCONNECTDATA 结构，该结构包含驱动程序返回 VPE 对象连接数据所需的信息。
返回值
DdVideoPortGetConnectInfo 返回以下回调代码之一：
注解
DdVideoPortGetConnectInfo 必须在支持 VPE 的 DirectDraw 驱动程序中实现。
DirectDraw 调用 DdVideoPortGetConnectInfo 以获取指定的 VPE 对象支持的连接数和每个连接的特征。 为指定的 VPE 对象调用两次 DdVideoPortGetConnectInfo：
- 在第一次调用中， lpGetConnect 处DD_GETVPORTCONNECTDATA结构的 lpConnect 成员为 NULL。 驱动程序应在 DD_GETVPORTCONNECTDATA 的 dwNumEntries 成员中写入 VPE 对象支持的连接数。 返回后，DirectDraw 将分配此数量的 DDVIDEOPORTCONNECT 结构，以传入对 DdVideoPortGetConnectInfo 的第二次调用。
- 第二次调用中， lpConnect 指向已分配的 DDVIDEOPORTCONNECT 结构的数组。 驱动程序应填充每个结构，以描述 VPE 对象支持的每个连接。 驱动程序还应返回 dwNumEntries 中支持的连接数。 请注意，驱动程序可以保证 lpConnect 指向的缓冲区足够大，足以保存所请求的连接信息。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | ddrawint.h (包括 Winddi.h) |