DD_UPDATEOVERLAYDATA-Struktur (ddrawint.h)

Die DD_UPDATEOVERLAYDATA-Struktur enthält Informationen, die zum Aktualisieren einer Überlagerungsoberfläche erforderlich sind.

Syntax

typedef struct _DD_UPDATEOVERLAYDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACE_LOCAL     lpDDDestSurface;
  RECTL                 rDest;
  PDD_SURFACE_LOCAL     lpDDSrcSurface;
  RECTL                 rSrc;
  DWORD                 dwFlags;
  DDOVERLAYFX           overlayFX;
  HRESULT               ddRVal;
  VOID                  *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;

Member

lpDD

Verweist auf eine DD_DIRECTDRAW_GLOBAL Struktur, die das Gerät des Treibers beschreibt.

lpDDDestSurface

Verweist auf eine DD_SURFACE_LOCAL-Struktur , die die microsoft DirectDraw-Oberfläche darstellt, die überlagert werden soll. Dieser Wert kann NULL sein, wenn DDOVER_HIDE in dwFlags angegeben ist.

rDest

Gibt eine RECTL-Struktur an, die die x-, y-, Breiten- und Höhe des Bereichs auf der Zieloberfläche enthält, die überlagert werden soll.

lpDDSrcSurface

Verweist auf eine DD_SURFACE_LOCAL Struktur, die die Überlagerungsoberfläche beschreibt.

rSrc

Gibt eine RECTL-Struktur an, die die x-, y-, Breiten- und Höhe des Bereichs auf der Quelloberfläche enthält, die für die Überlagerung verwendet werden soll.

dwFlags

Gibt an, wie der Treiber die Überlagerung behandeln soll. Dieser Member kann eine Kombination aus einem der folgenden Flags sein:

Flag	Bedeutung
DDOVER_ADDDIRTYRECT	Sollte vom Treiber ignoriert werden.
DDOVER_AUTOFLIP	Der Treiber sollte die Überlagerung automatisch übertragen, wenn die Hardware-Videoport-Autoflips. Treiber, die Videoporterweiterungen (VPE) unterstützen, müssen nur dieses Flag überprüfen.
DDOVER_BOB	Der Treiber sollte jedes Feld von VPE-Objektdaten einzeln anzeigen, ohne Nervositätsartefakte zu verursachen. Dieses Flag gilt sowohl für VPE als auch für Decoder, die ihr eigenes Flipping im Kernelmodus mithilfe der Videotransportfunktion im Kernelmodus durchführen möchten.
DDOVER_BOBHARDWARE	Gibt an, dass bob nicht durch Software oder Emulation, sondern durch Hardware ausgeführt wird. Treiber, die VPE unterstützen, müssen nur dieses Flag überprüfen.
DDOVER_DDFX	Der Treiber sollte die Überlagerungsoberfläche mit den attributen anzeigen, die vom overlayFX-Element angegeben werden.
DDOVER_HIDE	Der Treiber sollte die Überlagerung ausblenden. Das heißt, der Treiber sollte diese Überlagerung deaktivieren.
DDOVER_INTERLEAVED	Die Überlagerungsfläche besteht aus überlappenden Feldern. Treiber, die VPE unterstützen, müssen nur dieses Flag überprüfen.
DDOVER_KEYDEST	Der Treiber sollte den Farbschlüssel verwenden, der der Zieloberfläche zugeordnet ist.
DDOVER_KEYDESTOVERRIDE	Der Treiber sollte den dckDestColorKey-Member der DDOVERLAYFX-Struktur (beschrieben in der DirectDraw SDK-Dokumentation) als Zielfarbschlüssel anstelle des Der Zieloberfläche zugeordneten Farbschlüssels verwenden.
DDOVER_KEYSRC	Der Treiber sollte den Farbschlüssel verwenden, der der Zieloberfläche zugeordnet ist.
DDOVER_KEYSRCOVERRIDE	Der Treiber sollte den dckSrcColorKey-Member der DDOVERLAYFX-Struktur (beschrieben in der DirectDraw SDK-Dokumentation) als Quellfarbschlüssel anstelle des Der Zieloberfläche zugeordneten Farbschlüssels verwenden.
DDOVER_OVERRIDEBOBWEAVE	Bob-/Webentscheidungen sollten nicht von anderen Schnittstellen überschrieben werden. Wenn der Überlagerungsmixer dieses Flag festlegt, lässt DirectDraw nicht zu, dass ein Kernelmodustreiber die Kernelmodus-Videotransportfunktion verwendet, um die Hardware zwischen bob- und weave-Modus zu wechseln.
DDOVER_REFRESHALL	Sollte vom Treiber ignoriert werden.
DDOVER_REFRESHDIRTYRECTS	Sollte vom Treiber ignoriert werden.
DDOVER_SHOW	Der Treiber sollte die Überlagerung anzeigen. Das heißt, der Treiber sollte diese Überlagerung aktivieren.

overlayFX

Gibt eine DDOVERLAYFX-Struktur (in der DirectDraw SDK-Dokumentation beschrieben) an, die zusätzliche Effekte beschreibt, die der Treiber zum Aktualisieren der Überlagerung verwenden sollte. Der Treiber sollte diese Struktur nur verwenden, wenn eine der DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE oder DDOVER_KEYSRCOVERRIDE im dwFlags-Element festgelegt ist.

ddRVal

Gibt den Speicherort an, an dem der Treiber den Rückgabewert des DdUpdateOverlay-Rückrufs schreibt. Ein Rückgabecode von DD_OK gibt den Erfolg an. Weitere Informationen finden Sie unter Rückgabewerte für DirectDraw.

UpdateOverlay

Wird von der DirectDraw-API verwendet und sollte nicht vom Treiber ausgefüllt werden.

Anforderungen

Kopfzeile	ddrawint.h (einschließlich Winddi.h)

Weitere Informationen

DdUpdateOverlay