estrutura DD_UPDATEVPORTDATA (ddrawint.h)
A estrutura DD_UPDATEVPORTDATA contém as informações necessárias para iniciar, parar e alterar o objeto VPE (extensões de porta de vídeo ).
Sintaxe
typedef struct _DD_UPDATEVPORTDATA {
PDD_DIRECTDRAW_LOCAL lpDD;
PDD_VIDEOPORT_LOCAL lpVideoPort;
PDD_SURFACE_INT *lplpDDSurface;
PDD_SURFACE_INT *lplpDDVBISurface;
PDD_VIDEOPORTINFO lpVideoInfo;
DWORD dwFlags;
DWORD dwNumAutoflip;
DWORD dwNumVBIAutoflip;
HRESULT ddRVal;
VOID *UpdateVideoPort;
} *PDD_UPDATEVPORTDATA, DD_UPDATEVPORTDATA;
Membros
lpDD
Aponta para uma estrutura DD_DIRECTDRAW_LOCAL relevante apenas para o processo atual do Microsoft DirectDraw.
lpVideoPort
Aponta para uma estrutura DD_VIDEOPORT_LOCAL que representa esse objeto VPE.
lplpDDSurface
Aponta para uma matriz de estruturas de DD_SURFACE_INT que representam superfícies de vídeo regulares. Esse membro pode ser NULL.
lplpDDVBISurface
Aponta para uma matriz de estruturas DD_SURFACE_INT que representam superfícies de VBI . Esse membro pode ser NULL.
lpVideoInfo
Aponta para uma estrutura DDVIDEOPORTINFO que descreve como o objeto VPE deve transferir dados de vídeo para uma superfície. Esse membro pode ser NULL quando dwFlags é DDRAWI_VPORTSTOP.
dwFlags
Indica a ação a ser executada pelo objeto VPE. Esse membro deve ser um dos seguintes valores:
| Sinalizador | Significado |
|---|---|
| DDRAWI_VPORTSTART | O driver deve iniciar o fluxo de dados por meio do objeto VPE. |
| DDRAWI_VPORTSTOP | O driver deve interromper o fluxo de dados por meio do objeto VPE. |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate foi chamado com um novo conjunto de sinalizadores no membro dwVPFlags da estrutura DDVIDEOPORTINFO à qual o lpVideoInfo aponta. O driver deve alterar o fluxo de dados por meio do objeto VPE de acordo com os novos sinalizadores. |
dwNumAutoflip
Especifica o número de superfícies na lista à qual lplpDDSurface aponta. Se esse membro for maior que 1, lplpDDSurface será uma matriz de estruturas de superfície para acomodar o salto automático.
dwNumVBIAutoflip
Especifica o número de superfícies na lista à qual lplpDDVBISurface aponta. Se esse membro for maior que 1, lplpDDVBISurface será uma matriz de estruturas de superfície para acomodar o salto automático de dados VBI .
ddRVal
Especifica o local no qual o driver grava o valor retornado do retorno de chamada DdVideoPortUpdate . Um código de retorno de DD_OK indica êxito. Para obter mais informações, consulte Valores retornados para DirectDraw.
UpdateVideoPort
Usado pela API DirectDraw e não deve ser preenchido pelo driver.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ddrawint.h (inclua Winddi.h) |