structure DD_UPDATEVPORTDATA (ddrawint.h)
La structure DD_UPDATEVPORTDATA contient les informations nécessaires au démarrage, à l’arrêt et à la modification de l’objet d’extensions de port vidéo (VPE).
Syntaxe
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;
Membres
lpDD
Pointe vers une structure DD_DIRECTDRAW_LOCAL qui s’applique uniquement au processus Microsoft DirectDraw actuel.
lpVideoPort
Pointe vers une structure DD_VIDEOPORT_LOCAL qui représente cet objet VPE.
lplpDDSurface
Pointe vers un tableau de structures DD_SURFACE_INT qui représentent des surfaces vidéo régulières. Ce membre peut être NULL.
lplpDDVBISurface
Pointe vers un tableau de structures DD_SURFACE_INT qui représentent des surfaces VBI . Ce membre peut être NULL.
lpVideoInfo
Pointe vers une structure DDVIDEOPORTINFO qui décrit comment l’objet VPE doit transférer des données vidéo vers une surface. Ce membre peut être NULL lorsque dwFlags est DDRAWI_VPORTSTOP.
dwFlags
Indique l’action à effectuer par l’objet VPE. Ce membre doit avoir l’une des valeurs suivantes :
| Indicateur | Signification |
|---|---|
| DDRAWI_VPORTSTART | Le pilote doit démarrer le flux de données via l’objet VPE. |
| DDRAWI_VPORTSTOP | Le pilote doit arrêter le flux de données via l’objet VPE. |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate a été appelé avec un nouvel ensemble d’indicateurs dans le membre dwVPFlags de la structure DDVIDEOPORTINFO vers laquelle lpVideoInfo pointe. Le pilote doit modifier le flux de données via l’objet VPE en fonction des nouveaux indicateurs. |
dwNumAutoflip
Spécifie le nombre de surfaces de la liste vers lesquelles lplpDDSurface pointe. Si ce membre est supérieur à 1, lplpDDSurface est un tableau de structures de surface pour prendre en charge le glissement automatique.
dwNumVBIAutoflip
Spécifie le nombre de surfaces de la liste auxquelles lplpDDVBISurface pointe. Si ce membre est supérieur à 1, lplpDDVBISurface est un tableau de structures de surface pour prendre en charge la capture automatique des données VBI .
ddRVal
Spécifie l’emplacement dans lequel le pilote écrit la valeur de retour du rappel DdVideoPortUpdate . Un code de retour de DD_OK indique la réussite. Pour plus d’informations, consultez Valeurs de retour pour DirectDraw.
UpdateVideoPort
Utilisé par l’API DirectDraw et ne doit pas être renseigné par le pilote.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ddrawint.h (incluez Winddi.h) |