структура DD_VIDEOPORTCALLBACKS (ddrawint.h)

Статья
08/23/2023

Структура DD_VIDEOPORTCALLBACKS содержит указатели на функции обратного вызова расширений видеопорта Microsoft DirectDraw (VPE), поддерживаемые драйвером устройства.

Синтаксис

typedef struct DD_VIDEOPORTCALLBACKS {
  DWORD                          dwSize;
  DWORD                          dwFlags;
  PDD_VPORTCB_CANCREATEVIDEOPORT CanCreateVideoPort;
  PDD_VPORTCB_CREATEVIDEOPORT    CreateVideoPort;
  PDD_VPORTCB_FLIP               FlipVideoPort;
  PDD_VPORTCB_GETBANDWIDTH       GetVideoPortBandwidth;
  PDD_VPORTCB_GETINPUTFORMATS    GetVideoPortInputFormats;
  PDD_VPORTCB_GETOUTPUTFORMATS   GetVideoPortOutputFormats;
  LPVOID                         lpReserved1;
  PDD_VPORTCB_GETFIELD           GetVideoPortField;
  PDD_VPORTCB_GETLINE            GetVideoPortLine;
  PDD_VPORTCB_GETVPORTCONNECT    GetVideoPortConnectInfo;
  PDD_VPORTCB_DESTROYVPORT       DestroyVideoPort;
  PDD_VPORTCB_GETFLIPSTATUS      GetVideoPortFlipStatus;
  PDD_VPORTCB_UPDATE             UpdateVideoPort;
  PDD_VPORTCB_WAITFORSYNC        WaitForVideoPortSync;
  PDD_VPORTCB_GETSIGNALSTATUS    GetVideoSignalStatus;
  PDD_VPORTCB_COLORCONTROL       ColorControl;
} DD_VIDEOPORTCALLBACKS;

Члены

dwSize

Задает размер структуры DD_VIDEOPORTCALLBACKS в байтах.

dwFlags

Указывает, какие функции обратного вызова VPE реализованы драйвером. Для каждого бита, заданного в dwFlags, драйвер должен инициализировать соответствующий элемент указателя функции этой структуры. Этот элемент может быть одним или несколькими из следующих флагов:

DDHAL_VPORT32_CANCREATEVIDEOPORT
DDHAL_VPORT32_CREATEVIDEOPORT
DDHAL_VPORT32_FLIP
DDHAL_VPORT32_GETBANDWIDTH
DDHAL_VPORT32_GETINPUTFORMATS
DDHAL_VPORT32_GETOUTPUTFORMATS
DDHAL_VPORT32_GETAUTOFLIPSURF
DDHAL_VPORT32_GETFIELD
DDHAL_VPORT32_GETLINE
DDHAL_VPORT32_GETCONNECT
DDHAL_VPORT32_DESTROY
DDHAL_VPORT32_GETFLIPSTATUS
DDHAL_VPORT32_UPDATE
DDHAL_VPORT32_WAITFORSYNC
DDHAL_VPORT32_GETSIGNALSTATUS
DDHAL_VPORT32_COLORCONTROL

CanCreateVideoPort

Указывает на предоставленный драйвером обратный вызов DdVideoPortCanCreate .

CreateVideoPort

Указывает на предоставленный драйвером обратный вызов DdVideoPortCreate .

FlipVideoPort

Указывает на предоставленный драйвером обратный вызов DdVideoPortFlip .

GetVideoPortBandwidth

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetBandwidth .

GetVideoPortInputFormats

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetInputFormats .

GetVideoPortOutputFormats

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetOutputFormats .

lpReserved1

Зарезервировано для использования в системе и должно игнорироваться драйвером.

GetVideoPortField

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetField .

GetVideoPortLine

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetLine .

GetVideoPortConnectInfo

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetConnectInfo .

DestroyVideoPort

Указывает на предоставленный драйвером обратный вызов DdVideoPortDebase .

GetVideoPortFlipStatus

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetFlipStatus .

UpdateVideoPort

Указывает на предоставленный драйвером обратный вызов DdVideoPortUpdate .

WaitForVideoPortSync

Указывает на предоставленный драйвером обратный вызов DdVideoPortWaitForSync .

GetVideoSignalStatus

Указывает на предоставленный драйвером обратный вызов DdVideoPortGetSignalStatus .

ColorControl

Указывает на предоставленный драйвером обратный вызов DdVideoPortColorControl .

Записи, которые не используются драйвером отображения, должны иметь значение NULL. Драйвер должен инициализировать эту структуру при вызове функции DdGetDriverInfo с GUID_VideoPortCallbacks GUID.