DDCAPS_DX3-Struktur (ddraw.h)

Die DDCAPS-Struktur stellt die Funktionen der Hardware dar, die über das DirectDraw-Objekt verfügbar gemacht wird. Diese Struktur enthält eine DDSCAPS2-Struktur , die in diesem Kontext verwendet wird, um zu beschreiben, welche Arten von DirectDrawSurface-Objekten erstellt werden können. Möglicherweise ist es nicht möglich, alle von diesen Funktionen beschriebenen Oberflächen gleichzeitig zu erstellen. Diese Struktur wird mit der IDirectDraw7::GetCaps-Methode verwendet.

Die Ddraw.h-Headerdatei enthält mehrere Versionen dieser Struktur (z. B. DDCAPS_DX7). Weitere Informationen zum Ermitteln der zu verwendenden Version finden Sie unter Hinweise.

Syntax

typedef struct _DDCAPS_DX3 {
  DWORD   dwSize;
  DWORD   dwCaps;
  DWORD   dwCaps2;
  DWORD   dwCKeyCaps;
  DWORD   dwFXCaps;
  DWORD   dwFXAlphaCaps;
  DWORD   dwPalCaps;
  DWORD   dwSVCaps;
  DWORD   dwAlphaBltConstBitDepths;
  DWORD   dwAlphaBltPixelBitDepths;
  DWORD   dwAlphaBltSurfaceBitDepths;
  DWORD   dwAlphaOverlayConstBitDepths;
  DWORD   dwAlphaOverlayPixelBitDepths;
  DWORD   dwAlphaOverlaySurfaceBitDepths;
  DWORD   dwZBufferBitDepths;
  DWORD   dwVidMemTotal;
  DWORD   dwVidMemFree;
  DWORD   dwMaxVisibleOverlays;
  DWORD   dwCurrVisibleOverlays;
  DWORD   dwNumFourCCCodes;
  DWORD   dwAlignBoundarySrc;
  DWORD   dwAlignSizeSrc;
  DWORD   dwAlignBoundaryDest;
  DWORD   dwAlignSizeDest;
  DWORD   dwAlignStrideAlign;
  DWORD   dwRops[DD_ROP_SPACE];
  DDSCAPS ddsCaps;
  DWORD   dwMinOverlayStretch;
  DWORD   dwMaxOverlayStretch;
  DWORD   dwMinLiveVideoStretch;
  DWORD   dwMaxLiveVideoStretch;
  DWORD   dwMinHwCodecStretch;
  DWORD   dwMaxHwCodecStretch;
  DWORD   dwReserved1;
  DWORD   dwReserved2;
  DWORD   dwReserved3;
  DWORD   dwSVBCaps;
  DWORD   dwSVBCKeyCaps;
  DWORD   dwSVBFXCaps;
  DWORD   dwSVBRops[DD_ROP_SPACE];
  DWORD   dwVSBCaps;
  DWORD   dwVSBCKeyCaps;
  DWORD   dwVSBFXCaps;
  DWORD   dwVSBRops[DD_ROP_SPACE];
  DWORD   dwSSBCaps;
  DWORD   dwSSBCKeyCaps;
  DWORD   dwSSBFXCaps;
  DWORD   dwSSBRops[DD_ROP_SPACE];
  DWORD   dwReserved4;
  DWORD   dwReserved5;
  DWORD   dwReserved6;
} DDCAPS_DX3;

Member

dwSize

Größe der Struktur in Bytes. Dieses Element muss initialisiert werden, bevor die Struktur verwendet wird.

dwCaps

Dieser Wert besteht aus mindestens einem der folgenden Flags, die Hardware- und Treiberfunktionen angeben.

DDCAPS_3D

Die Anzeigehardware verfügt über eine 3D-Beschleunigung.

DDCAPS_ALIGNBOUNDARYDEST

DirectDraw unterstützt nur diese Überlagerungszielrechtecke mit der x-Achse, die an den DwAlignBoundaryDest-Grenzen der Oberfläche ausgerichtet ist.

DDCAPS_ALIGNBOUNDARYSRC

DirectDraw unterstützt nur diese überlagerten Quellrechtecke mit der x-Achse, die an den DwAlignBoundarySrc-Grenzen der Oberfläche ausgerichtet ist.

DDCAPS_ALIGNSIZEDEST

DirectDraw unterstützt nur diese Überlagerungszielrechtecke, deren x-Achsengrößen in Pixel dwAlignSizeDest-Vielfache sind.

DDCAPS_ALIGNSIZESRC

DirectDraw unterstützt nur diese Überlagerungsquellrechtecke, deren x-Achsengrößen in Pixel dwAlignSizeSrc-Multiples sind.

DDCAPS_ALIGNSTRIDE

DirectDraw erstellt Anzeigespeicheroberflächen mit einer Stride-Ausrichtung, die dem dwAlignStrideAlign-Wert entspricht.

DDCAPS_ALPHA

Die Anzeigehardware unterstützt Nur-Alpha-Oberflächen.

DDCAPS_BANKSWITCHED

Die Anzeigehardware wird bankseitig umgeschaltet und ist beim zufälligen Zugriff auf den Anzeigespeicher potenziell sehr langsam.

DDCAPS_BLT

Anzeigehardware kann Bitblockübertragungsvorgänge (Bitblt) durchführen.

DDCAPS_BLTCOLORFILL

Die Anzeigehardware kann mit einem Blitter farbfüllen.

DDCAPS_BLTDEPTHFILL

Anzeigehardware ist in der Lage, Z-Puffer mit einem Blitter zu füllen.

DDCAPS_BLTFOURCC

Anzeigehardware kann bei Bitblt-Vorgängen Farbraumkonvertierungen durchführen.

DDCAPS_BLTQUEUE

Anzeigehardware kann asynchrone Bitbltvorgänge ausführen.

DDCAPS_BLTSTRETCH

Die Anzeigehardware kann während Bitbltvorgängen gestreckt werden.

DDCAPS_CANBLTSYSMEM

Anzeigehardware kann in den oder aus dem Systemspeicher eingeteilt werden.

DDCAPS_CANCLIP

Anzeigehardware kann mit Blitting abgeschnitten werden.

DDCAPS_CANCLIPSTRETCHED

Anzeigehardware kann beim Stretch-Blitting abgeschnitten werden.

DDCAPS_COLORKEY

Unterstützt eine Form von Farbtasten in Overlay- oder Bitblt-Vorgängen. Spezifischere Informationen zur Farbschlüsselfunktion finden Sie im dwCKeyCaps-Element .

DDCAPS_COLORKEYHWASSIST

Die Farbtaste ist teilweise hardwareunterstützt. Dies bedeutet, dass möglicherweise andere Ressourcen (CPU oder Videospeicher) verwendet werden. Wenn dieses Bit nicht festgelegt ist, ist die vollständige Hardwareunterstützung vorhanden.

DDCAPS_GDI

Anzeigehardware wird für GDI freigegeben.

DDCAPS_NOHARDWARE

Es gibt keine Hardwareunterstützung.

DDCAPS_OVERLAY

Anzeigehardware unterstützt Überlagerungen.

DDCAPS_OVERLAYCANTCLIP

Anzeigehardware unterstützt Überlagerungen, kann sie aber nicht abschneiden.

DDCAPS_OVERLAYFOURCC

Overlayhardware kann bei Überlagerungsvorgängen Farbraumkonvertierungen durchführen.

DDCAPS_OVERLAYSTRETCH

Overlayhardware kann gestreckt werden. Die Elemente dwMinOverlayStretch und dwMaxOverlayStretch enthalten gültige Daten.

DDCAPS_PALETTE

DirectDraw kann DirectDrawPalette-Objekte für andere Oberflächen als die primäre Oberfläche erstellen und unterstützen.

DDCAPS_PALETTEVSYNC

DirectDraw kann eine Palette aktualisieren, die mit der vertikalen Aktualisierung synchronisiert ist.

DDCAPS_READSCANLINE

Anzeigehardware kann die aktuelle Scanzeile zurückgeben.

DDCAPS_VBI

Anzeigehardware kann einen vertikal leeren Interrupt generieren.

DDCAPS_ZBLTS

Unterstützt die Verwendung von z-Puffern mit Bitbltvorgängen.

DDCAPS_ZOVERLAYS

Unterstützt die Verwendung der IDirectDrawSurface7::UpdateOverlayZOrder-Methode als Z-Wert für Overlays, um deren Layering zu steuern.

dwCaps2

Dieser Wert besteht aus mindestens einem der folgenden Flags, die weitere Hardware- und Treiberfunktionen angeben.

DDCAPS2_AUTOFLIPOVERLAY

Das Overlay kann jedes Mal, wenn eine Videoport-VSYNC auftritt, automatisch auf die nächste Oberfläche in der Flipping-Kette gedreht werden, sodass der Videoport und das Overlay das Video ohne CPU-Mehraufwand doppelt puffern können. Diese Option ist nur gültig, wenn die Oberfläche Daten von einem Videoport empfängt. Wenn die Videoportdaten nicht oder nicht interlaced sind, werden sie auf jeder VSYNC umgedreht. Wenn die Daten im Arbeitsspeicher verschachtelt werden, werden alle anderen VSYNC-Dateien umgedreht.

DDCAPS2_CANBOBHARDWARE

Die Überlagerungshardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen.

DDCAPS2_CANBOBINTERLEAVED

Die Überlagerungshardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen, während er im Arbeitsspeicher verschachtelt ist, ohne Artefakte zu verursachen, die normalerweise ohne spezielle Hardwareunterstützung auftreten können. Diese Option ist nur gültig, wenn die Oberfläche Daten von einem Videoport empfängt und das Video mindestens zweimal in vertikale Richtung gezoomt wird.

DDCAPS2_CANBOBNONINTERLEAVED

Die Overlayhardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen, während er nicht im Arbeitsspeicher verschachtelt ist, ohne Artefakte zu verursachen, die normalerweise ohne spezielle Hardwareunterstützung auftreten können. Diese Option ist nur gültig, wenn die Oberfläche Daten von einem Videoport empfängt und das Video mindestens zweimal in vertikale Richtung gezoomt wird.

DDCAPS2_CANCALIBRATEGAMMA

Das System verfügt über einen Kalibrator, der die Gammarampe automatisch so anpassen kann, dass das Ergebnis auf allen Systemen, die über einen Kalibrator verfügen, identisch ist. Um den Kalibrator beim Festlegen neuer Gammastufen aufzurufen, verwenden Sie beim Aufrufen der IDirectDrawGammaControl::SetGammaRamp-Methode das flag DDSGR_CALIBRATE. Das Kalibrieren von Gammarampen verursacht einen gewissen Verarbeitungsaufwand und sollte nicht häufig verwendet werden.

DDCAPS2_CANDROPZ16BIT

Sechzehn-Bit-RGBZ-Werte können in 16-Bit-RGB-Werte konvertiert werden. (Das System unterstützt keine 8-Bit-Konvertierungen.)

DDCAPS2_CANFLIPODDEVEN

Der Treiber kann ungerade und gerade Flip-Vorgänge ausführen, wie durch die DDFLIP_ODD- und DDFLIP_EVEN-Flags angegeben, die mit der IDirectDrawSurface7::Flip-Methode verwendet werden.

DDCAPS2_CANMANAGETEXTURE

Der Direct3D-Textur-Manager verwendet diese Funktion, um zu entscheiden, ob verwaltete Oberflächen in nicht lokalem Videospeicher abgelegt werden sollen. Wenn die Funktion festgelegt ist, platziert der Textur-Manager verwaltete Oberflächen in nicht lokalem Videospeicher. Treiber, die keine Textur aus dem lokalen Videospeicher erstellen können, sollten diese Funktion nicht festlegen.

DDCAPS2_CANRENDERWINDOWED

Der Treiber kann im Fenstermodus gerendert werden.

DDCAPS2_CERTIFIED

Anzeigehardware ist zertifiziert.

DDCAPS2_COLORCONTROLPRIMARY

Die primäre Oberfläche enthält Farbsteuerelemente (für instance, Gamma).

DDCAPS2_COLORCONTROLOVERLAY

Die Überlagerungsoberfläche enthält Farbsteuerelemente (z. B. Helligkeit und Schärfe).

DDCAPS2_COPYFOURCC

Der Treiber unterstützt das Aufschneiden einer BELIEBIGEN FOURCC-Oberfläche auf eine andere Oberfläche desselben FOURCC.

DDCAPS2_FLIPINTERVAL

Der Treiber antwortet auf die DDFLIP_INTERVAL*-Flags. (Weitere Informationen zu diesen Flags finden Sie unter IDirectDrawSurface7::Flip).

DDCAPS2_FLIPNOVSYNC

Der Treiber antwortet auf das flag DDFLIP_NOVSYNC (Weitere Informationen zu diesem Flag finden Sie unter IDirectDrawSurface7::Flip).

DDCAPS2_NO2DDURING3DSCENE

Zweidimensionale Vorgänge wie IDirectDrawSurface7::Blt und IDirectDrawSurface7::Lock können nicht auf Oberflächen ausgeführt werden, die Direct3D zwischen Aufrufen der Methoden BeginScene und EndScene verwendet.

DDCAPS2_NONLOCALVIDMEM

Der Anzeigetreiber unterstützt Oberflächen im nicht lokalen Videospeicher.

DDCAPS2_NONLOCALVIDMEMCAPS

Bitblt-Funktionen für nicht lokale Videospeicheroberflächen unterscheiden sich von lokalen Videospeicheroberflächen. Wenn dieses Flag vorhanden ist, ist auch das DDCAPS2_NONLOCALVIDMEM-Flag vorhanden.

DDCAPS2_NOPAGELOCKREQUIRED

DMA-Bitblt-Vorgänge werden auf Systemspeicheroberflächen unterstützt, die nicht seitengebunden sind.

DDCAPS2_PRIMARYGAMMA

Unterstützt dynamische Gammarampen für die primäre Oberfläche.

DDCAPS2_STEREO

Neu für DirectX 7.0. Aktiviert das dwSVCaps-Bit , um den Stereomodus zu unterstützen. Der Treiber kann Stereo in mindestens einem anderen Modus als dem aktuellen Modus ausführen. Die Anwendung kann IDirectDraw7::GetDisplayMode oder IDirectDraw7::EnumDisplayModes verwenden, um Stereoinformationen pro Modus abzurufen.

DDCAPS2_TEXMANINNONLOCALVIDMEM

Neu für DirectX 7.0. Der Direct3D-Textur-Manager verwendet diese Funktion, um zu entscheiden, ob verwaltete Oberflächen in nicht lokalem Videospeicher abgelegt werden sollen. Wenn die Funktion festgelegt ist, platziert der Textur-Manager verwaltete Oberflächen in nicht lokalem Videospeicher. Treiber, die keine Textur aus dem lokalen Videospeicher erstellen können, sollten diese Funktion nicht festlegen.

DDCAPS2_VIDEOPORT

Die Anzeigehardware unterstützt Livevideos.

DDCAPS2_WIDESURFACES

Die Anzeigeoberfläche unterstützt Flächen, die breiter als die primäre Oberfläche sind.

dwCKeyCaps

Dieser Wert besteht aus mindestens einem der folgenden Flags, die Farbschlüsselfunktionen angeben.

DDCKEYCAPS_DESTBLT

Unterstützt transparentes Durchschneiden mit einem Farbschlüssel, der die austauschbaren Bits der Zieloberfläche für RGB-Farben identifiziert.

DDCKEYCAPS_DESTBLTCLRSPACE

Unterstützt transparentes Blitting mit einem Farbraum, der die austauschbaren Bits der Zieloberfläche für RGB-Farben identifiziert.

DDCKEYCAPS_DESTBLTCLRSPACEYUV

Unterstützt transparentes Blitting mit einem Farbraum, der die austauschbaren Bits der Zieloberfläche für YUV-Farben identifiziert.

DDCKEYCAPS_DESTBLTYUV

Unterstützt transparentes Blitting mit einem Farbschlüssel, der die austauschbaren Bits der Zieloberfläche für YUV-Farben identifiziert.

DDCKEYCAPS_DESTOVERLAY

Unterstützt das Überlagern mit Farbtasten der austauschbaren Bits der Zieloberfläche, die für RGB-Farben überlagert werden sollen.

DDCKEYCAPS_DESTOVERLAYCLRSPACE

Unterstützt einen Farbraum als Farbschlüssel für das Ziel von RGB-Farben.

DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV

Unterstützt einen Farbraum als Farbschlüssel für das Ziel von YUV-Farben.

DDCKEYCAPS_DESTOVERLAYONEACTIVE

Unterstützt nur einen aktiven Zielfarbschlüsselwert für sichtbare Überlagerungsflächen.

DDCKEYCAPS_DESTOVERLAYYUV

Unterstützt die Überlagerung mithilfe der Farbtasten der ersetzbaren Bits der Zieloberfläche, die für YUV-Farben überlagert werden sollen.

DDCKEYCAPS_NOCOSTOVERLAY

Gibt an, dass es keine Kompromisse bei der Bandbreite für die Verwendung des Farbschlüssels mit einer Überlagerung gibt.

DDCKEYCAPS_SRCBLT

Unterstützt transparentes Blitting, wobei die Farbtaste für die Quelle mit dieser Oberfläche für RGB-Farben verwendet wird.

DDCKEYCAPS_SRCBLTCLRSPACE

Unterstützt transparentes Blitting, wobei ein Farbraum für die Quelle mit dieser Oberfläche für RGB-Farben verwendet wird.

DDCKEYCAPS_SRCBLTCLRSPACEYUV

Unterstützt transparentes Blitting, wobei ein Farbraum für die Quelle mit dieser Oberfläche für YUV-Farben verwendet wird.

DDCKEYCAPS_SRCBLTYUV

Unterstützt transparentes Durchschneiden, wobei die Farbtaste für die Quelle mit dieser Oberfläche für YUV-Farben verwendet wird.

DDCKEYCAPS_SRCOVERLAY

Unterstützt die Überlagerung mithilfe der Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für RGB-Farben.

DDCKEYCAPS_SRCOVERLAYCLRSPACE

Unterstützt die Überlagerung, wobei ein Farbraum als Quellfarbschlüssel für die Überlagerungsoberfläche für RGB-Farben verwendet wird.

DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV

Unterstützt die Überlagerung, wobei ein Farbraum als Quellfarbschlüssel für die Überlagerungsoberfläche für YUV-Farben verwendet wird.

DDCKEYCAPS_SRCOVERLAYONEACTIVE

Unterstützt nur einen aktiven Quellfarbschlüsselwert für sichtbare Überlagerungsflächen.

DDCKEYCAPS_SRCOVERLAYYUV

Unterstützt die Überlagerung, wobei die Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für YUV-Farben verwendet wird.

dwFXCaps

Dieser Wert besteht aus einem oder mehreren der folgenden Flags, die die Funktionen für die Treiberdehnung und -effekte angeben.

DDFXCAPS_BLTALPHA

Unterstützt alphablendte Bitblt-Vorgänge.

DDFXCAPS_BLTARITHSTRETCHY

Verwendet arithmetische Operationen anstelle von Pixelverdopplungstechniken, um Oberflächen während eines bitblt-Vorgangs zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf.

DDFXCAPS_BLTARITHSTRETCHYN

Verwendet arithmetische Operationen anstelle von Pixelverdopplungstechniken, um Oberflächen während eines bitblt-Vorgangs zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf und funktioniert nur für ganzzahlige Dehnungen (×1, ×2 usw.).

DDFXCAPS_BLTFILTER

Der Treiber kann eine Oberflächenrekonstruktionsfilterung für verzogene Bitblts durchführen.

DDFXCAPS_BLTMIRRORLEFTRIGHT

Unterstützt die Spiegelung von links nach rechts in einem bitblt-Vorgang.

DDFXCAPS_BLTMIRRORUPDOWN

Unterstützt die Spiegelung von oben nach unten in einem Bitblt-Vorgang.

DDFXCAPS_BLTROTATION

Unterstützt beliebige Drehung in einem Bitblt-Vorgang.

DDFXCAPS_BLTROTATION90

Unterstützt 90-Grad-Drehungen in einem Bitblt-Vorgang.

DDFXCAPS_BLTSHRINKX

Unterstützt das beliebige Verkleinern einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSHRINKXN

Unterstützt ganzzahliges Verkleinern (×1, ×2 usw.) einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSHRINKY

Unterstützt das willkürliche Verkleinern einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSHRINKYN

Unterstützt ganzzahliges Verkleinern (×1, ×2 usw.) einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSTRETCHX

Unterstützt die beliebige Dehnung einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSTRETCHXN

Unterstützt ganzzahliges Strecken (×1, ×2 usw.) einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSTRETCHY

Unterstützt die beliebige Dehnung einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTSTRETCHYN

Unterstützt ganzzahliges Strecken (×1, ×2 usw.) einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Bitblt-Vorgänge gültig.

DDFXCAPS_BLTTRANSFORM

Unterstützt geometrische Transformationen (oder Verzerrungen) für eingeteilte Sprites. Transformationen werden derzeit nicht für explizite Bitbltvorgänge unterstützt.

DDFXCAPS_OVERLAYALPHA

Unterstützt Alpha-Blending für Überlagerungsflächen.

DDFXCAPS_OVERLAYARITHSTRETCHY

Verwendet arithmetische Vorgänge anstelle von Pixelverdopplungstechniken, um Überlagerungsflächen zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf.

DDFXCAPS_OVERLAYARITHSTRETCHYN

Verwendet arithmetische Vorgänge anstelle von Pixelverdopplungstechniken, um Überlagerungsflächen zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf und funktioniert nur für ganzzahlige Dehnungen (×1, ×2 usw.).

DDFXCAPS_OVERLAYFILTER

Unterstützt die Oberflächenrekonstruktionsfilterung für verzweigte Überlagerungs-Sprites. Die Filterung wird derzeit nicht für explizit angezeigte Überlagerungsflächen unterstützt (solche, die mit Aufrufen von IDirectDrawSurface7::UpdateOverlay angezeigt werden).

DDFXCAPS_OVERLAYMIRRORLEFTRIGHT

Unterstützt die Spiegelung von Überlagerungen über die vertikale Achse.

DDFXCAPS_OVERLAYMIRRORUPDOWN

Unterstützt die Spiegelung von Überlagerungen über die horizontale Achse.

DDFXCAPS_OVERLAYSHRINKX

Unterstützt das beliebige Verkleinern einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass verkleinern verfügbar ist.

DDFXCAPS_OVERLAYSHRINKXN

Unterstützt ganzzahliges Verkleinern (×1, ×2 usw.) einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass verkleinern verfügbar ist.

DDFXCAPS_OVERLAYSHRINKY

Unterstützt das willkürliche Verkleinern einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass verkleinern verfügbar ist.

DDFXCAPS_OVERLAYSHRINKYN

Unterstützt ganzzahliges Verkleinern (×1, ×2 usw.) einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass verkleinern verfügbar ist.

DDFXCAPS_OVERLAYSTRETCHX

Unterstützt die beliebige Dehnung einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass das Stretchen verfügbar ist.

DDFXCAPS_OVERLAYSTRETCHXN

Unterstützt ganzzahliges Strecken (×1, ×2 usw.) einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass das Stretchen verfügbar ist.

DDFXCAPS_OVERLAYSTRETCHY

Unterstützt die beliebige Dehnung einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass das Stretchen verfügbar ist.

DDFXCAPS_OVERLAYSTRETCHYN

Unterstützt ganzzahliges Strecken (×1, ×2 usw.) einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Dieses Flag gibt nur die Funktionen einer Oberfläche an. es gibt nicht an, dass das Stretchen verfügbar ist.

DDFXCAPS_OVERLAYTRANSFORM

Unterstützt geometrische Transformationen (oder Verzerrungen) für Überlagerungs-Sprites. Transformationen werden derzeit nicht für explizit angezeigte Überlagerungsflächen unterstützt (solche, die mit Aufrufen von IDirectDrawSurface7::UpdateOverlay angezeigt werden).

dwFXAlphaCaps

Dieser Wert besteht aus mindestens einem der folgenden Flags, die die Alphafunktionen des Treibers angeben.

DDFXALPHACAPS_BLTALPHAEDGEBLEND

Unterstützt alpha-Blending am Rand einer farbbasierten Quelloberfläche. Wird für Bitbltvorgänge verwendet.

DDFXALPHACAPS_BLTALPHAPIXELS

Unterstützt Alphainformationen im Pixelformat. Die Bittiefe von Alphainformationen im Pixelformat kann 1, 2, 4 oder 8 sein. Der Alphawert wird undurchsichtiger, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig transparente Wert. Wird für Bitbltvorgänge verwendet.

DDFXALPHACAPS_BLTALPHAPIXELSNEG

Unterstützt Alphainformationen im Pixelformat. Die Bittiefe von Alphainformationen im Pixelformat kann 1, 2, 4 oder 8 sein. Der Alphawert wird transparenter, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig undurchsichtige Wert. Dieses Flag kann nur verwendet werden, wenn DDCAPS_ALPHA festgelegt ist. Wird für Bitbltvorgänge verwendet.

DDFXALPHACAPS_BLTALPHASURFACES

Unterstützt Nur-Alpha-Oberflächen. Die Bittiefe einer Rein-Alpha-Oberfläche kann 1, 2, 4 oder 8 sein. Der Alphawert wird undurchsichtiger, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig transparente Wert. Wird für Bitblt-Vorgänge verwendet.

DDFXALPHACAPS_BLTALPHASURFACESNEG

Gibt an, dass der Alphakanal transparenter wird, wenn der Alphawert zunimmt. Die Tiefe der Alphakanaldaten kann 1, 2, 4 oder 8 sein. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig undurchsichtige Wert. Dieses Flag kann nur festgelegt werden, wenn DDCAPS_ALPHA festgelegt wurde. Wird für Bitblt-Vorgänge verwendet.

DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND

Unterstützt die Alphamischung am Rand einer Quelloberfläche mit Farbschlüssel. Wird für Überlagerungen verwendet.

DDFXALPHACAPS_OVERLAYALPHAPIXELS

Unterstützt Alphainformationen im Pixelformat. Die Bittiefe von Alphainformationen im Pixelformat kann 1, 2, 4 oder 8 sein. Der Alphawert wird undurchsichtiger, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig transparente Wert. Wird für Überlagerungen verwendet.

DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG

Unterstützt Alphainformationen im Pixelformat. Die Bittiefe von Alphainformationen im Pixelformat kann 1, 2, 4 oder 8 sein. Der Alphawert wird transparenter, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig undurchsichtige Wert. Dieses Flag kann nur verwendet werden, wenn DDCAPS_ALPHA festgelegt wurde. Wird für Überlagerungen verwendet.

DDFXALPHACAPS_OVERLAYALPHASURFACES

Unterstützt Nur-Alpha-Oberflächen. Die Bittiefe einer Rein-Alpha-Oberfläche kann 1, 2, 4 oder 8 sein. Der Alphawert wird undurchsichtiger, wenn der Alphawert zunimmt. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig transparente Wert. Wird für Überlagerungen verwendet.

DDFXALPHACAPS_OVERLAYALPHASURFACESNEG

Gibt an, dass der Alphakanal transparenter wird, wenn der Alphawert zunimmt. Die Tiefe der Alphakanaldaten kann 1, 2, 4 oder 8 sein. Unabhängig von der Tiefe der Alphainformationen ist 0 immer der vollständig undurchsichtige Wert. Dieses Flag kann nur verwendet werden, wenn DDCAPS_ALPHA festgelegt wurde. Wird für Überlagerungen verwendet.

dwPalCaps

Dieser Wert besteht aus mindestens einem der folgenden Flags, die Palettenfunktionen angeben.

DDPCAPS_1BIT

Unterstützt Paletten, die 1-Bit-Farbeinträge (zwei Farben) enthalten.

DDPCAPS_2BIT

Unterstützt Paletten, die 2-Bit-Farbeinträge (vier Farben) enthalten.

DDPCAPS_4BIT

Unterstützt Paletten, die 4-Bit-Farbeinträge (16 Farben) enthalten.

DDPCAPS_8BIT

Unterstützt Paletten, die 8-Bit-Farbeinträge (256 Farben) enthalten.

DDPCAPS_8BITENTRIES

Gibt einen Index für einen 8-Bit-Farbindex an. Dieses Feld ist nur gültig, wenn es mit der funktion DDPCAPS_1BIT, DDPCAPS_2BIT oder DDPCAPS_4BIT verwendet wird und wenn die Zieloberfläche 8 Bit pro Pixel (bpp) beträgt. Jeder Farbeintrag ist 1 Byte lang und ist ein Index für eine 8-Bpp-Palette auf der Zieloberfläche.

DDPCAPS_ALPHA

Unterstützt Paletten, die eine Alphakomponente enthalten. Bei alphafähigen Paletten muss der peFlags-Member jeder PALETTEENTRY-Struktur , die die Palette enthält, als einzelner 8-Bit-Alphawert interpretiert werden (zusätzlich zu den Farbdaten in den Elementen peRed, peGreen und peBlue ). Eine palette, die mit diesem Flag erstellt wurde, kann nur an einer Texturoberfläche angefügt werden.

DDPCAPS_ALLOW256

Unterstützt Paletten, für die alle 256 Einträge definiert sein können.

DDPCAPS_PRIMARYSURFACE

Die Palette ist an die primäre Oberfläche angefügt. Das Ändern der Palette wirkt sich sofort auf die Anzeige aus, es sei denn, die funktion DDPCAPS_VSYNC wird angegeben und unterstützt.

DDPCAPS_PRIMARYSURFACELEFT

Die Palette wird an der primären Oberfläche auf der linken Seite angebracht. Das Ändern der Palette wirkt sich sofort auf die Anzeige aus, es sei denn, die funktion DDPCAPS_VSYNC wird angegeben und unterstützt.

DDPCAPS_VSYNC

Die Palette kann synchron mit der Aktualisierungsrate des Monitors geändert werden.

dwSVCaps

Dieser Wert besteht aus einem oder mehreren der folgenden Flags, die Stereosichtfunktionen angeben.

DDSVCAPS_RESERVED1, DDSVCAPS_RESERVED2, DDSVCAPS_RESERVED3, DDSVCAPS_RESERVED4

Reservierte Flags.

DDSVCAPS_STEREOSEQUENTIAL

Neu für DirectX 7.0. Der Treiber kann Stereo in mindestens einem anderen Modus als dem aktuellen Modus ausführen. Die Anwendung kann IDirectDraw7::GetDisplayMode oder IDirectDraw7::EnumDisplayModes verwenden, um Stereoinformationen pro Modus abzurufen.

dwAlphaBltConstBitDepths

DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 2, 4 oder 8 Bits pro Pixel an.)

dwAlphaBltPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 1, 2, 4 oder 8 Bits pro Pixel an.)

dwAlphaBltSurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 1, 2, 4 oder 8 Bits pro Pixel an.)

dwAlphaOverlayConstBitDepths

DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 2, 4 oder 8 Bits pro Pixel an.)

dwAlphaOverlayPixelBitDepths

DDBD_1, DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 1, 2, 4 oder 8 Bits pro Pixel an.)

dwAlphaOverlaySurfaceBitDepths

DDBD_1, DDBD_2, DDBD_4 oder DDBD_8. (Geben Sie 1, 2, 4 oder 8 Bits pro Pixel an.)

dwZBufferBitDepths

DDBD_8, DDBD_16, DDBD_24 oder DDBD_32. (Geben Sie 8, 16, 24 oder 32 Bits pro Pixel an.) Dieser Member ist für DirectX 6.0 und höher veraltet. Verwenden Sie IDirect3D7::EnumZBufferFormats , um Informationen zu unterstützten Tiefenpufferformaten abzurufen.

dwVidMemTotal

Gesamtmenge des Anzeigespeichers auf dem Gerät in Byte, abzüglich des für die primäre Oberfläche reservierten Arbeitsspeichers und aller vom Treiber reservierten privaten Datenstrukturen. (Dieser Wert entspricht dem gesamten Videospeicher, der von der IDirectDraw7::GetAvailableVidMem-Methode gemeldet wird.)

dwVidMemFree

Freier Anzeigespeicher. Dieser Wert entspricht dem Wert in dwVidMemTotal, abzüglich des arbeitsspeichers, der derzeit von der Anwendung für Oberflächen belegt wird. Im Gegensatz zur IDirectDraw7::GetAvailableVidMem-Methode , die den für einen bestimmten Oberflächentyp (z. B. eine Textur) verfügbaren Arbeitsspeicher meldet, spiegelt dieser Wert den für jeden Oberflächentyp verfügbaren Speicher wider.

dwMaxVisibleOverlays

Maximale Anzahl sichtbarer Überlagerungen oder Überlagerungs-Sprites.

dwCurrVisibleOverlays

Aktuelle Anzahl sichtbarer Überlagerungen oder Überlagerungs-Sprites.

dwNumFourCCCodes

Anzahl der FourCC-Codes.

dwAlignBoundarySrc

Quellrechteckausrichtung für eine Überlagerungsfläche in Pixel.

dwAlignSizeSrc

Ausrichtung der Quellrechteckgröße für eine Überlagerungsfläche in Pixel. Überlagerungsquellrechtecke müssen eine Pixelbreite aufweisen, die ein Vielfaches dieses Werts ist.

dwAlignBoundaryDest

Zielrechteckausrichtung für eine Überlagerungsfläche in Pixel.

dwAlignSizeDest

Zielrechteck-Größenausrichtung für eine Überlagerungsfläche in Pixel. Überlagerungszielrechtecke müssen eine Pixelbreite aufweisen, die ein Vielfaches dieses Werts ist.

dwAlignStrideAlign

Stride-Ausrichtung.

dwRops[DD_ROP_SPACE]

Rastervorgänge werden unterstützt.

ddsCaps

Eine DDSCAPS2-Struktur , die allgemeine Oberflächenfunktionen enthält.

dwMinOverlayStretch

Minimaler Überlagerungs-Stretchfaktor, multipliziert mit 1000. Beispiel: 1,3 = 1300.

dwMaxOverlayStretch

Maximaler Überlagerungs-Stretchfaktor, multipliziert mit 1000. Beispiel: 1,3 = 1300.

dwMinLiveVideoStretch

Veraltet; nicht verwenden.

dwMaxLiveVideoStretch

Veraltet; nicht verwenden.

dwMinHwCodecStretch

Veraltet; nicht verwenden.

dwMaxHwCodecStretch

Veraltet; nicht verwenden.

dwReserved1

Reserviert

dwReserved2

Reserviert

dwReserved3

Reserviert

dwSVBCaps

Treiberspezifische Funktionen für Bitblts aus dem Systemspeicher zur Anzeige des Arbeitsspeichers. Gültige Flags sind mit den Bitblt-bezogenen Flags identisch, die mit dem dwCaps-Member verwendet werden.

dwSVBCKeyCaps

Treiberfarbfunktionen für Bitblts vom Systemspeicher zum Anzeigen des Arbeitsspeichers. Gültige Flags sind identisch mit den bitblt-bezogenen Flags, die mit dem dwCKeyCaps-Member verwendet werden.

dwSVBFXCaps

Treiber FX-Funktionen für Bitblts aus dem Systemspeicher zum Anzeigen des Arbeitsspeichers. Gültige Flags sind identisch mit den bitblt-bezogenen Flags, die mit dem dwFXCaps-Member verwendet werden.

dwSVBRops[DD_ROP_SPACE]

Rastervorgänge, die für Bitblts aus dem Systemspeicher unterstützt werden, um Arbeitsspeicher anzuzeigen.

dwVSBCaps

Treiberspezifische Funktionen für Bitblts vom Anzeigespeicher in den Systemspeicher. Gültige Flags sind mit den Bitblt-bezogenen Flags identisch, die mit dem dwCaps-Member verwendet werden.

dwVSBCKeyCaps

Treiberfarbfunktionen für Bitblts vom Anzeigespeicher in den Systemspeicher. Gültige Flags sind identisch mit den bitblt-bezogenen Flags, die mit dem dwCKeyCaps-Member verwendet werden.

dwVSBFXCaps

Treiber FX-Funktionen für Bitblts vom Anzeigespeicher in den Systemspeicher. Gültige Flags sind mit den bitblt-bezogenen Flags identisch, die mit dem dwFXCaps-Member verwendet werden.

dwVSBRops[DD_ROP_SPACE]

Rastervorgänge werden für Bitblts vom Anzeigespeicher in den Systemspeicher unterstützt.

dwSSBCaps

Treiberspezifische Funktionen für Bitblts vom Systemspeicher in den Systemspeicher. Gültige Flags sind mit den bitblt-bezogenen Flags identisch, die mit dem dwCaps-Member verwendet werden.

dwSSBCKeyCaps

Treiberfarbfunktionen für Bitblts vom Systemspeicher in den Systemspeicher. Gültige Flags sind mit den bitblt-bezogenen Flags identisch, die mit dem dwCKeyCaps-Element verwendet werden.

dwSSBFXCaps

Treiber-FX-Funktionen für Bitblts vom Systemspeicher in den Systemspeicher. Gültige Flags sind mit den bitblt-bezogenen Flags identisch, die mit dem dwFXCaps-Member verwendet werden.

dwSSBRops[DD_ROP_SPACE]

Rastervorgänge, die für Bitblts vom Systemspeicher in den Systemspeicher unterstützt werden.

dwReserved4

Reserviert

dwReserved5

Reserviert

dwReserved6

Reserviert

Bemerkungen

Aus Gründen der Abwärtskompatibilität enthält die Ddraw.h-Headerdatei mehrere Definitionen der DDCAPS-Struktur. Die Version, die den Präprozessor übergibt, wird durch den Wert der konstanten DIRECTDRAW_VERSION bestimmt.

Anforderungen

Kopfzeile	ddraw.h