DD_UPDATEVPORTDATA-Struktur (ddrawint.h)
Die DD_UPDATEVPORTDATA-Struktur enthält die Informationen, die zum Starten, Beenden und Ändern des VPE-Objekts (Videoporterweiterungen) erforderlich sind.
Syntax
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;
Member
lpDD
Verweist auf eine DD_DIRECTDRAW_LOCAL Struktur, die nur für den aktuellen Microsoft DirectDraw-Prozess relevant ist.
lpVideoPort
Zeigt auf eine DD_VIDEOPORT_LOCAL-Struktur , die dieses VPE-Objekt darstellt.
lplpDDSurface
Zeigt auf ein Array von DD_SURFACE_INT Strukturen, die reguläre Videooberflächen darstellen. Dieses Element kann NULL sein.
lplpDDVBISurface
Zeigt auf ein Array von DD_SURFACE_INT Strukturen, die VBI-Oberflächen darstellen. Dieses Element kann NULL sein.
lpVideoInfo
Verweist auf eine DDVIDEOPORTINFO-Struktur , die beschreibt, wie das VPE-Objekt Videodaten auf eine Oberfläche übertragen soll. Dieses Element kann NULL sein, wenn dwFlags DDRAWI_VPORTSTOP ist.
dwFlags
Gibt die Aktion an, die vom VPE-Objekt ausgeführt werden soll. Dieser Member muss einer der folgenden Werte sein:
| Flag | Bedeutung |
|---|---|
| DDRAWI_VPORTSTART | Der Treiber sollte den Datenfluss über das VPE-Objekt starten. |
| DDRAWI_VPORTSTOP | Der Treiber sollte den Datenfluss durch das VPE-Objekt beenden. |
| DDRAWI_VPORTUPDATE | DdVideoPortUpdate wurde mit einem neuen Satz von Flags im dwVPFlags-Member der DDVIDEOPORTINFO-Struktur aufgerufen, auf die lpVideoInfo verweist. Der Treiber sollte den Datenfluss über das VPE-Objekt entsprechend den neuen Flags ändern. |
dwNumAutoflip
Gibt die Anzahl der Oberflächen in der Liste an, auf die lplpDDSurface verweist. Wenn dieses Element größer als 1 ist, ist lplpDDSurface ein Array von Oberflächenstrukturen, um autoflipping aufzunehmen.
dwNumVBIAutoflip
Gibt die Anzahl der Oberflächen in der Liste an, auf die lplpDDVBISurface verweist. Wenn dieser Member größer als 1 ist, ist lplpDDVBISurface ein Array von Oberflächenstrukturen, um das automatische Flipping von VBI-Daten zu ermöglichen.
ddRVal
Gibt den Speicherort an, an dem der Treiber den Rückgabewert des DdVideoPortUpdate-Rückrufs schreibt. Ein Rückgabecode von DD_OK zeigt den Erfolg an. Weitere Informationen finden Sie unter Rückgabewerte für DirectDraw.
UpdateVideoPort
Wird von der DirectDraw-API verwendet und sollte nicht vom Treiber ausgefüllt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ddrawint.h (include Winddi.h) |