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。 驅動程式應該寫入 VPE 物件在 dwNumEntries 成員中DD_GETVPORTCONNECTDATA支持的連線數目。 傳回時，DirectDraw 會配置這個數目的 DDVIDEOPORTCONNECT 結構，以傳入第二次呼叫 DdVideoPortGetConnectInfo。
- 第二次呼叫中， lpConnect 會指向已配置 之 DDVIDEOPORTCONNECT 結構的陣列。 驅動程式應該填入每個結構，以描述 VPE 物件支援的每個連線。 驅動程式也應該傳回 dwNumEntries 中支持的連線數目。 請注意，驅動程式保證 lpConnect 指向的緩衝區夠大，足以保存所要求的連線資訊。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | ddrawint.h (包括 Winddi.h) |