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)

Weitere Informationen

DDVIDEOPORTINFO

DdVideoPortUpdate