функция обратного вызова 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) |