Поделиться через


функция обратного вызова PDD_VPORTCB_GETVPORTCONNECT (ddrawint.h)

Функция обратного вызова DdVideoPortGetConnectInfo возвращает подключения, поддерживаемые указанным объектом VPE.

Синтаксис

PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;

DWORD PddVportcbGetvportconnect(
  PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

Указывает на DD_GETVPORTCONNECTDATA структуру, содержащую сведения, необходимые драйверу для возврата данных подключения к объекту VPE.

Возвращаемое значение

DdVideoPortGetConnectInfo возвращает один из следующих кодов обратного вызова:

Комментарии

DdVideoPortGetConnectInfo необходимо реализовать в драйверах DirectDraw, поддерживающих VPE.

DirectDraw вызывает DdVideoPortGetConnectInfo , чтобы получить количество подключений, поддерживаемых указанным объектом VPE, и характеристики каждого подключения. DdVideoPortGetConnectInfo вызывается дважды для указанного объекта VPE:

  • В первом вызове элемент lpConnect структуры DD_GETVPORTCONNECTDATA в lpGetConnect имеет значение NULL. Драйвер должен записать количество подключений, поддерживаемых объектом VPE, в члене dwNumEntries DD_GETVPORTCONNECTDATA. После возврата DirectDraw выделит это количество структур DDVIDEOPORTCONNECT для передачи во втором вызове DdVideoPortGetConnectInfo.
  • Во втором вызове lpConnect указывает на массив выделенных структур DDVIDEOPORTCONNECT . Драйвер должен заполнить каждую структуру, чтобы описать каждое соединение, которое поддерживает объект VPE. Драйвер также должен возвращать количество поддерживаемых подключений в dwNumEntries. Обратите внимание, что драйверу гарантируется, что буфер, к которому имеются точки lpConnect , достаточно велик для хранения запрашиваемых сведений о подключении.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть ddrawint.h (включая Winddi.h)

См. также раздел

DDVIDEOPORTCONNECT

DD_GETVPORTCONNECTDATA