estructura DD_VIDEOPORTCALLBACKS (ddrawint.h)

Artículo
03/09/2023

La estructura DD_VIDEOPORTCALLBACKS contiene punteros de entrada a las funciones de devolución de llamada de extensiones de puerto de vídeo (VPE) de Microsoft DirectDraw que admite un controlador de dispositivo.

Sintaxis

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;

Miembros

dwSize

Especifica el tamaño en bytes de esta estructura de DD_VIDEOPORTCALLBACKS.

dwFlags

Indica qué funciones de devolución de llamada de VPE ha implementado el controlador. Para cada bit establecido en dwFlags, el controlador debe inicializar el miembro de puntero de función correspondiente de esta estructura. Este miembro puede ser una o varias de las marcas siguientes:

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

Apunta a la devolución de llamada DdVideoPortCanCreate proporcionada por el controlador.

CreateVideoPort

Apunta a la devolución de llamada DdVideoPortCreate proporcionada por el controlador.

FlipVideoPort

Apunta a la devolución de llamada DdVideoPortFlip proporcionada por el controlador.

GetVideoPortBandwidth

Apunta a la devolución de llamada DdVideoPortGetBandwidth proporcionada por el controlador.

GetVideoPortInputFormats

Apunta a la devolución de llamada DdVideoPortGetInputFormats proporcionada por el controlador.

GetVideoPortOutputFormats

Apunta a la devolución de llamada DdVideoPortGetOutputFormats proporcionada por el controlador.

lpReserved1

Reservado para uso del sistema y debe omitirlo el controlador.

GetVideoPortField

Apunta a la devolución de llamada DdVideoPortGetField proporcionada por el controlador.

GetVideoPortLine

Apunta a la devolución de llamada DdVideoPortGetLine proporcionada por el controlador.

GetVideoPortConnectInfo

Apunta a la devolución de llamada DdVideoPortGetConnectInfo proporcionada por el controlador.

DestroyVideoPort

Apunta a la devolución de llamada DdVideoPortDestroy proporcionada por el controlador.

GetVideoPortFlipStatus

Apunta a la devolución de llamada DdVideoPortGetFlipStatus proporcionada por el controlador.

UpdateVideoPort

Apunta a la devolución de llamada DdVideoPortUpdate proporcionada por el controlador.

WaitForVideoPortSync

Apunta a la devolución de llamada DdVideoPortWaitForSync proporcionada por el controlador.

GetVideoSignalStatus

Apunta a la devolución de llamada DdVideoPortGetSignalStatus proporcionada por el controlador.

ColorControl

Apunta a la devolución de llamada DdVideoPortColorControl proporcionada por el controlador.

Comentarios

Las entradas que el controlador de pantalla no usa deben establecerse en NULL. El controlador debe inicializar esta estructura cuando se llama a su función DdGetDriverInfo con el GUID de GUID_VideoPortCallbacks.