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) |