estrutura DD_VIDEOPORTCALLBACKS (ddrawint.h)

Artigo
03/09/2023

A estrutura DD_VIDEOPORTCALLBACKS contém ponteiros de entrada para funções de retorno de chamada VPE (extensões de porta de vídeo) do Microsoft DirectDraw compatíveis com um driver de dispositivo.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura DD_VIDEOPORTCALLBACKS.

dwFlags

Indica quais funções de retorno de chamada VPE o driver implementou. Para cada conjunto de bits em dwFlags, o driver deve inicializar o membro do ponteiro de função correspondente dessa estrutura. Esse membro pode ser um ou mais dos seguintes sinalizadores:

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

Aponta para o retorno de chamada DdVideoPortCanCreate fornecido pelo driver.

CreateVideoPort

Aponta para o retorno de chamada DdVideoPortCreate fornecido pelo driver.

FlipVideoPort

Aponta para o retorno de chamada DdVideoPortFlip fornecido pelo driver.

GetVideoPortBandwidth

Aponta para o retorno de chamada DdVideoPortGetBandwidth fornecido pelo driver.

GetVideoPortInputFormats

Aponta para o retorno de chamada DdVideoPortGetInputFormats fornecido pelo driver.

GetVideoPortOutputFormats

Aponta para o retorno de chamada DdVideoPortGetOutputFormats fornecido pelo driver.

lpReserved1

Reservado para uso do sistema e deve ser ignorado pelo driver.

GetVideoPortField

Aponta para o retorno de chamada DdVideoPortGetField fornecido pelo driver.

GetVideoPortLine

Aponta para o retorno de chamada DdVideoPortGetLine fornecido pelo driver.

GetVideoPortConnectInfo

Aponta para o retorno de chamada DdVideoPortGetConnectInfo fornecido pelo driver.

DestroyVideoPort

Aponta para o retorno de chamada DdVideoPortDestroy fornecido pelo driver.

GetVideoPortFlipStatus

Aponta para o retorno de chamada DdVideoPortGetFlipStatus fornecido pelo driver.

UpdateVideoPort

Aponta para o retorno de chamada DdVideoPortUpdate fornecido pelo driver.

WaitForVideoPortSync

Aponta para o retorno de chamada DdVideoPortWaitForSync fornecido pelo driver.

GetVideoSignalStatus

Aponta para o retorno de chamada DdVideoPortGetSignalStatus fornecido pelo driver.

ColorControl

Aponta para o retorno de chamada DdVideoPortColorControl fornecido pelo driver.

Comentários

As entradas que o driver de exibição não usa devem ser definidas como NULL. O driver deve inicializar essa estrutura quando sua função DdGetDriverInfo for chamada com o GUID GUID_VideoPortCallbacks.