DDVIDEOPORTCAPS-Struktur (dvp.h)

Artikel
08/23/2023

Die DDVIDEOPORTCAPS-Struktur beschreibt die Funktionen und Ausrichtungseinschränkungen eines Hardwarevideoports.

Syntax

typedef struct _DDVIDEOPORTCAPS {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwMaxWidth;
  DWORD dwMaxVBIWidth;
  DWORD dwMaxHeight;
  DWORD dwVideoPortID;
  DWORD dwCaps;
  DWORD dwFX;
  DWORD dwNumAutoFlipSurfaces;
  DWORD dwAlignVideoPortBoundary;
  DWORD dwAlignVideoPortPrescaleWidth;
  DWORD dwAlignVideoPortCropBoundary;
  DWORD dwAlignVideoPortCropWidth;
  DWORD dwPreshrinkXStep;
  DWORD dwPreshrinkYStep;
  DWORD dwNumVBIAutoFlipSurfaces;
  DWORD dwNumPreferredAutoflip;
  WORD  wNumFilterTapsX;
  WORD  wNumFilterTapsY;
} *LPDDVIDEOPORTCAPS, DDVIDEOPORTCAPS;

Member

dwSize

Gibt die Größe der -Struktur in Byte an.

dwFlags

Geben Sie an, welche Member in dieser Struktur gültige Daten enthalten. Dieser Member kann ein bitweises OR mit einem der folgenden Werte sein:

Flag	Bedeutung
DDVPD_ALIGN	Alle Ausrichtungsmember sind gültig. Dazu zählen unter anderem folgende Einstellungen: dwAlignVideoPortBoundary, dwAlignVideoPortPrescaleWidth, dwAlignVideoPortCropBoundary und dwAlignVideoPortCropWidth.
DDVPD_AUTOFLIP	DwNumAutoFlipSurfaces ist gültig.
DDVPD_CAPS	Das dwCaps-Element ist gültig.
DDVPD_FX	Das dwFX-Element ist gültig.
DDVPD_HEIGHT	Das dwMaxHeight-Element ist gültig.
DDVPD_ID	Das dwVideoPortID-Element ist gültig.
DDVPD_WIDTH	Die Elemente dwMaxWidth und dwMaxVBIWidth sind gültig.

dwMaxWidth

Gibt die maximale Feldbreite in Pixel an, die vom Hardwarevideoport unterstützt wird. Dieser Wert wird in der Regel durch die Anzahl der Bits im Breitenregister vorgegeben.

dwMaxVBIWidth

Gibt die maximale Breite in Anzahl von Beispielen in einer Zeile von VBI-Daten an, die vom Hardwarevideoport unterstützt werden. Dieser Wert kann größer als die normale Feldbreite sein, wenn der Hardwarevideoport überstempelte VBI-Daten unterstützt.

dwMaxHeight

Gibt die maximale Feldhöhe in Pixeln an, die vom Hardwarevideoport unterstützt wird. Dieser Wert wird in der Regel durch die Anzahl der Bits im Höhenregister bestimmt.

dwVideoPortID

Gibt die Hardwarevideoport-ID für diesen Eintrag an. Dieser Member sollte die Indexnummer dieser DDVIDEOPORTCAPS-Struktur innerhalb des Arrays sein, auf das der lpDDVideoPortCaps-Member der DD_DIRECTDRAW_GLOBAL-Struktur verweist. Dieser Wert reicht von 0 bis (dwMaxVideoPorts - 1). (dwMaxVideoPorts ist ein Mitglied der DDCORECAPS-Struktur .) Wenn das Gerät nur einen Hardwarevideoport unterstützt, sollte dieser Member 0 (null) sein.

dwCaps

Gibt eine Reihe von Flags an, die die funktionen angeben, die von diesem Hardwarevideoport unterstützt werden. Dieser Member kann ein bitweises OR mit einem der folgenden Werte sein:

Flag	Bedeutung
DDVPCAPS_AUTOFLIP	Ein Flip kann automatisch ausgeführt werden, um ein Reißen zu vermeiden.
DDVPCAPS_COLORCONTROL	Der Hardwarevideoport kann Farboperationen für die eingehenden Daten ausführen, bevor sie in den Framepuffer geschrieben werden.
DDVPCAPS_INTERLACED	Der Hardwarevideoport unterstützt Interlaced-Video.
DDVPCAPS_NONINTERLACED	Der Hardwarevideoport unterstützt Nicht-Interlaced-Video.
DDVPCAPS_OVERSAMPLEDVBI	Der Hardwarevideoport kann VBI-Daten in einer anderen Breite oder einem anderen Format als die normalen Videodaten akzeptieren.
DDVPCAPS_READBACKFIELD	Das Gerät kann einen Wert zurückgeben, der angibt, ob das aktuelle Feld eines Interlaced-Signals gerade oder ungerade ist.
DDVPCAPS_READBACKLINE	Das Gerät kann die Nummer der aktuellen Videozeile zurückgeben, die in den Framepuffer geschrieben wird.
DDVPCAPS_SHAREABLE	Wird von Microsoft DirectDraw ignoriert.
DDVPCAPS_SKIPEVENFIELDS	Der Hardwarevideoport kann automatisch gerade Videofelder verwerfen.
DDVPCAPS_SKIPODDFIELDS	Der Hardwarevideoport kann ungerade Videofelder automatisch verwerfen.
DDVPCAPS_SYNCMASTER	Das Gerät kann die Grafik-V-Synchronisierung mit der V-Synchronisierung des Hardwarevideoporttreibers steuern.
DDVPCAPS_SYSTEMMEMORY	Der Hardwarevideoport kann Daten direkt in den Systemspeicher schreiben.
DDVPCAPS_VBISURFACE	Die Daten innerhalb des vertikalen Leerungsintervalls können auf eine andere Oberfläche geschrieben werden.

dwFX

Gibt eine Reihe von Flags an, die die von diesem Hardwarevideoport unterstützten Effekte angeben. Dieser Member ist ein bitweises OR mit einem der folgenden Werte:

Flag	Bedeutung
DDVPFX_CROPTOPDATA	Der Hardwarevideoport unterstützt das eingeschränkte Zuschneiden, um die vertikalen Intervalldaten zuzuschneiden.
DDVPFX_CROPX	Der Hardwarevideoport kann eingehende Daten in x-Richtung zuschneiden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_CROPY	Der Hardwarevideoport kann eingehende Daten in y-Richtung zuschneiden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_IGNOREVBIXCROP	Der Hardwarevideoport kann die linken und rechten Zuschneidekoordinaten für Videodaten ignorieren, wenn übersampelte VBI-Daten zuschneiden.
DDVPFX_INTERLEAVE	Der Hardwarevideoport unterstützt das Überlappen von Feldern im Speicher.
DDVPFX_MIRRORLEFTRIGHT	Der Hardwarevideoport unterstützt die Spiegelung von links nach rechts, da die Videodaten in den Framepuffer geschrieben werden.
DDVPFX_MIRRORUPDOWN	Der Hardwarevideoport unterstützt die Spiegelung von oben nach unten, während die Videodaten in den Framepuffer geschrieben werden.
DDVPFX_PRESHRINKX	Daten können willkürlich in x-Richtung verkleinert werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESHRINKXB	Daten können durch negative Potenzen von 2 (1/2, 1/4, 1/8 usw.) in x-Richtung verkleinert werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESHRINKXS	Daten können in Schritten von 1/dwPreshrinkXStep in x-Richtung verkleinern, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESHRINKY	Daten können willkürlich in y-Richtung verkleinert werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESHRINKYB	Daten können durch negative Potenzen von 2 (1/2, 1/4, 1/8 usw.) in y-Richtung verkleinert werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESHRINKYS	Daten können in Schritten von 1/dwPreshrinkYStep in y-Richtung verkleinern, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESTRETCHX	Daten können beliebig in x-Richtung gestreckt werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESTRETCHXN	Daten können durch ganzzahlige Faktoren in x-Richtung gestreckt werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESTRETCHY	Daten können beliebig in y-Richtung gestreckt werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_PRESTRETCHYN	Daten können durch ganzzahlige Faktoren in y-Richtung gestreckt werden, bevor sie auf die Oberfläche geschrieben werden.
DDVPFX_VBICONVERT	Daten innerhalb des vertikalen Leerungsintervalls können unabhängig von den verbleibenden Videodaten konvertiert werden.
DDVPFX_VBINOSCALE	Die Skalierung kann für Daten innerhalb des vertikalen Leerungsintervalls deaktiviert werden.

dwNumAutoFlipSurfaces

dwAlignVideoPortBoundary

Gibt die Byteausrichtungseinschränkung in Byte an, bei der der Hardwarevideoport relativ zum Ursprung der Oberfläche in x-Richtung ausgerichtet werden kann.

dwAlignVideoPortPrescaleWidth

Gibt die Byteausrichtungseinschränkung in Byte an, die bestimmt, wie breit die Hardwarevideoportdaten sein können, wenn die Vorskalierung ausgeführt wird.

dwAlignVideoPortCropBoundary

Gibt die Byteausrichtungseinschränkung in Bytes für die linke Zuschneidekoordinate an.

dwAlignVideoPortCropWidth

Gibt die Byteausrichtungseinschränkung in Bytes für die Breite des Zuschneiderechtecks an.

dwPreshrinkXStep

Gibt an, dass der Hardwarevideoport die Breite der Videodaten in Schritten von 1/dwPreshrinkXStep verkleinern kann. Dieser Member ist nur gültig, wenn die DDVPFX_PRESHRINKXS-Funktion angegeben ist.

dwPreshrinkYStep

Gibt an, dass der Hardwarevideoport die Höhe der Videodaten in Schritten von 1/dwPreshrinkYStep verkleinern kann. Dieser Member ist nur gültig, wenn die DDVPFX_PRESHRINKYS-Funktion angegeben ist.

dwNumVBIAutoFlipSurfaces

Gibt die maximale Anzahl von Oberflächen an, die in der Autoflip-Kette unterstützt werden, wenn der Hardwarevideoport das automatische Flipping unterstützt. Wenn der Hardwarevideoport das automatische Flippen nicht unterstützt, sollte der Treiber diesen Member auf 0 (null) festlegen. Dieser Member funktioniert auf die gleiche Weise wie dwNumAutoFlipSurfaces , mit der Ausnahme, dass es sich nur auf Geräte bezieht, die die VBI-Daten an eine andere Oberfläche senden können, als auf die das normale Video geschrieben wird.

dwNumPreferredAutoflip

Gibt die optimale Anzahl von automatisch flippierbaren Oberflächen an, die von der Hardware unterstützt werden.

wNumFilterTapsX

Gibt die Anzahl der Tippen an, die die Präskalierung in x-Richtung verwendet. Der Wert 0 gibt keine Vorskalierung an, der Wert 1 die Replikation usw.

wNumFilterTapsY

Gibt die Anzahl der Tippen an, die die Präskalierung in y-Richtung verwendet. Der Wert 0 gibt keine Vorskalierung an, der Wert 1 die Replikation usw.

Hinweise

Der Treiber meldet die von der DDVIDEOPORTCAPS-Struktur beschriebenen Funktionen, wenn seine DdGetDriverInfo-Funktion mit der GUID_VideoPortCaps GUID aufgerufen wird.

Anforderungen


Kopfzeile	dvp.h (dvp.h einschließen)

Weitere Informationen

DDCORECAPS

DD_DIRECTDRAW_GLOBAL

DdGetDriverInfo