DDCORECAPS-Struktur (ddrawi.h)

Die DDCORECAPS-Struktur gibt die Kernfunktionen des Microsoft DirectDraw-Treibers und seines Geräts an, die für eine Anwendung über das DirectDraw-Objekt verfügbar gemacht werden.

Syntax

typedef struct _DDCORECAPS {
  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   dwMaxVideoPorts;
  DWORD   dwCurrVideoPorts;
  DWORD   dwSVBCaps2;
} DDCORECAPS;

Member

dwSize

Gibt die Größe dieser DDCORECAPS-Struktur in Bytes an.

dwCaps

Gibt ein Flag an, das die Funktionen des Treibers angibt. Der Treiber sollte das entsprechende DDCAPS_Xxx-Bit für jede unterstützte Funktion festlegen.

Flag Bedeutung
DDCAPS_3D Die Anzeigehardware verfügt über eine 3D-Beschleunigung.
DDCAPS_ALIGNBOUNDARYDEST DirectDraw unterstützt nur die Quellrechtecke, deren x-Achse an den dwAlignBoundaryDest-Grenzen der Oberfläche ausgerichtet ist.
DDCAPS_ALIGNBOUNDARYSRC DirectDraw unterstützt nur die Quellrechtecke mit der x-Achse, die an den dwAlignBoundarySrc-Grenzen der Oberfläche ausgerichtet ist.
DDCAPS_ALIGNSIZEDEST DirectDraw unterstützt nur die Quellrechtecke, deren x-Achsengrößen in Bytes dwAlignSizeDest-Vielfache sind.
DDCAPS_ALIGNSIZESRC DirectDraw unterstützt nur die Quellrechtecke, deren x-Achsengrößen in Bytes dwAlignSizeSrc-Multiples sind.
DDCAPS_ALIGNSTRIDE DirectDraw erstellt Anzeigespeicheroberflächen mit einer Stride-Ausrichtung, die dem dwAlignStrideAlign-Wert entspricht.
DDCAPS_ALPHA Die Anzeigehardware unterstützt einen Alphakanal bei Blit-Vorgängen.
DDCAPS_BANKSWITCHED Die Anzeigehardware wird bankseitig umgeschaltet und ist beim zufälligen Zugriff auf den Anzeigespeicher potenziell sehr langsam. Wenn dieses Funktionsbit vom Microsoft Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert.
DDCAPS_BLT Die Anzeigehardware ist für Blitvorgänge fähig.
DDCAPS_BLTCOLORFILL Die Anzeigehardware kann mit einem Blitter farbfüllen.
DDCAPS_BLTDEPTHFILL Die Displayhardware ist in der Lage, Z-Puffer mit einem Blitter zu füllen.
DDCAPS_BLTFOURCC Die Anzeigehardware kann bei Blit-Vorgängen Farbraumkonvertierungen durchführen.
DDCAPS_BLTQUEUE Die Anzeigehardware kann asynchrone Blitvorgänge ausführen.
DDCAPS_BLTSTRETCH Die Anzeigehardware kann sich bei Spaltvorgängen dehnen.
DDCAPS_CANBLTSYSMEM Die Anzeigehardware kann in den oder aus dem Systemspeicher eingeteilt werden.
DDCAPS_CANCLIP Die Anzeigehardware kann mit Blitting abgeschnitten werden.
DDCAPS_CANCLIPSTRETCHED Die Anzeigehardware kann beim Stretch-Blitting abgeschnitten werden.
DDCAPS_COLORKEY Eine Form von Farbtasten in Überlagerungs- oder Blitvorgängen wird unterstützt. Spezifischere Informationen zur Farbschlüsselfunktion finden Sie im dwCKeyCaps-Element .
DDCAPS_COLORKEYHWASSIST Die Farbtaste wird hardwareseitig unterstützt.
DDCAPS_GDI Die Anzeigehardware wird für GDI freigegeben. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert.
DDCAPS_NOHARDWARE Es ist keine Hardwareunterstützung vorhanden.
DDCAPS_OVERLAY Die Anzeigehardware unterstützt Überlagerungen.
DDCAPS_OVERLAYCANTCLIP Die Anzeigehardware unterstützt Überlagerungen, kann sie aber nicht abschneiden.
DDCAPS_OVERLAYFOURCC Die Overlayhardware kann bei Überlagerungsvorgängen Farbraumkonvertierungen durchführen.
DDCAPS_OVERLAYSTRETCH Die Overlayhardware kann gestreckt werden.
DDCAPS_PALETTE DirectDraw ist in der Lage, DirectDrawPalette-Objekte für mehr als nur die primäre Oberfläche zu erstellen und zu unterstützen. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert.
DDCAPS_PALETTEVSYNC DirectDraw kann eine Palette aktualisieren, die mit der vertikalen Aktualisierung synchronisiert ist.
DDCAPS_READSCANLINE Die Anzeigehardware kann die aktuelle Scanzeile zurückgeben.
DDCAPS_STEREOVIEW Die Displayhardware verfügt über Stereo-Vision-Funktionen.
DDCAPS_VBI Die Anzeigehardware kann einen vertikalen leeren Interrupt generieren.
DDCAPS_ZBLTS Unterstützt die Verwendung von z-Puffern mit blit-Vorgängen.
DDCAPS_ZOVERLAYS Unterstützt die Verwendung der UpdateOverlayZOrder-Methode der Anwendung als Z-Wert für Überlagerungen, um deren Layering zu steuern. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert.

dwCaps2

Geben Sie weitere Funktionen des Treibers an. Der Treiber sollte das entsprechende DDCAPS2_Xxx-Bit für jede unterstützte Funktion festlegen.

Flag Bedeutung
DDCAPS2_AUTOFLIPOVERLAY Das Overlay kann bei jeder V-Synchronisierung eines Hardwarevideoports automatisch auf die nächste Oberfläche in der Flip Chain gedreht werden, sodass das VPE-Objekt (VideoPort Extensions) und das Overlay das Video ohne CPU-Mehraufwand doppelt puffern können. Diese Option ist nur gültig, wenn die Oberfläche Daten vom Hardwarevideoport empfängt. Wenn die Hardwarevideoportdaten nicht interlaced oder noninterleaved sind, wird jede V-Synchronisierung umgedreht. Wenn die Daten im Arbeitsspeicher verschachtelt werden, wird jede andere V-Synchronisierung umgedreht.
DDCAPS2_CANAUTOGENMIPMAP
Nur DirectX 9.0 und höhere Versionen.
Der Treiber und sein Gerät unterstützen die automatische Neugenerierung der Unterebenen von mipmap-Texturen.
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 VPE-Objekt empfängt, und ist nur gültig, wenn das Video um mindestens 200 Prozent in die 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 VPE-Objekt empfängt, und ist nur gültig, wenn das Video um mindestens 200 Prozent in die vertikale Richtung gezoomt wird.
DDCAPS2_CANCALIBRATEGAMMA Ein Kalibror steht zur Verfügung, um die Gammarampe entsprechend den physikalischen Anzeigeeigenschaften so anzupassen, dass das Ergebnis auf allen kalibrierten Systemen identisch ist.
DDCAPS2_CANDROPZ16BIT Sechzehn-Bit-RGBZ-Werte können in 16-Bit-RGB-Werte konvertiert werden. (Das System unterstützt keine Acht-Bit-Konvertierungen.)
DDCAPS2_CANFLIPODDEVEN Der Treiber unterstützt bob mithilfe von Software, ohne ein VPE-Objekt zu verwenden.
DDCAPS2_CANMANAGERESOURCE Der Treiber unterstützt die Verwaltung von Ressourcen.
DDCAPS2_CANMANAGETEXTURE Der Treiber unterstützt die Verwaltung von Texturen.
DDCAPS2_CANRENDERWINDOWED Der Treiber kann im Fenstermodus gerendert werden.
DDCAPS2_CERTIFIED Die Anzeigehardware ist zertifiziert.
DDCAPS2_COLORCONTROLOVERLAY Die Überlagerungsoberfläche enthält Farbsteuerelemente (Helligkeit, Schärfe usw.).
DDCAPS2_COLORCONTROLPRIMARY Die primäre Oberfläche enthält Farbsteuerelemente (Gamma usw.).
DDCAPS2_COPYFOURCC Der Treiber unterstützt das Aufschneiden einer BELIEBIGEN FOURCC-Oberfläche auf eine andere Oberfläche desselben FOURCC.
DDCAPS2_FLIPINTERVAL Der Treiber reagiert auf die Flags DDFLIP_INTERVAL2, DDFLIP_INTERVAL3 und DDFLIP_INTERVAL4.
DDCAPS2_FLIPNOVSYNC Der Treiber antwortet auf DDFLIP_FLIPNOVSYNC.
DDCAPS2_NO2DDURING3DSCENE Der Treiber kann keine 2D-Vorgänge wie DdBlt oder DdLock auf Oberflächen ineinandergreifen, die Microsoft Direct3D zwischen Aufrufen der Methoden IDirect3DDevice::BeginScene und IDirect3DDevice::EndScene verwendet.
DDCAPS2_NONLOCALVIDMEM Der Treiber unterstützt nicht lokale Anzeigespeicher.
DDCAPS2_NONLOCALVIDMEMCAPS Blit-Funktionen für nicht lokale Anzeigespeicheroberflächen unterscheiden sich von lokalen Anzeigespeicheroberflächen. Wenn dieses Flag vorhanden ist, ist auch das DDCAPS2_NONLOCALVIDMEM-Flag vorhanden.
DDCAPS2_NOPAGELOCKREQUIRED Der Treiber sollte für Blits aufgerufen werden, die Systemspeicheroberflächen enthalten, auch wenn die Systemspeicheroberflächen nicht ausgelagert sind.
DDCAPS2_PRIMARYGAMMA Der Treiber unterstützt ladebare Gammarampen für die primäre Oberfläche.
DDCAPS2_VIDEOPORT Die Anzeigehardware enthält einen Hardwarevideoport.
DDCAPS2_WIDESURFACES Der Anzeigetreiber kann Oberflächen erstellen, die breiter als die primäre Oberfläche sind. Treiber, die dieses Bit festlegen, sollten damit rechnen, dass CreateSurface-Anforderungen von Anwendungen für Oberflächen empfangen werden, die größer als die primäre Oberfläche sind.

dwCKeyCaps

Geben Sie die Farbschlüsselfunktionen von Oberflächen an. Der Treiber sollte das entsprechende DDCKEYCAPS_Xxx-Bit für jede funktion festlegen, die er unterstützt.

Flag Bedeutung
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.
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 das Überlagern mithilfe von Farbtasten der austauschbaren Bits der Zieloberfläche, die für YUV-Farben überlagert werden.
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 mithilfe der Farbtaste für die Quelle mit dieser Oberfläche für RGB-Farben.
DDCKEYCAPS_SRCBLTCLRSPACE Unterstützt transparentes Blitting mit einem Farbraum für die Quelle mit dieser Oberfläche für RGB-Farben.
DDCKEYCAPS_SRCBLTCLRSPACEYUV Unterstützt transparentes Blitting mit einem Farbraum für die Quelle mit dieser Oberfläche für YUV-Farben.
DDCKEYCAPS_SRCBLTYUV Unterstützt transparentes Blitting mithilfe des Farbschlüssels für die Quelle mit dieser Oberfläche für YUV-Farben.
DDCKEYCAPS_SRCOVERLAY Unterstützt das Überlagern mithilfe der Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für RGB-Farben.
DDCKEYCAPS_SRCOVERLAYCLRSPACE Unterstützt das Überlagern mit einem Farbraum als Quellfarbschlüssel für die Überlagerungsoberfläche für RGB-Farben.
DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV Unterstützt das Überlagern mit einem Farbraum als Quellfarbschlüssel für die Überlagerungsoberfläche für YUV-Farben.
DDCKEYCAPS_SRCOVERLAYONEACTIVE Unterstützt nur einen aktiven Quellfarbschlüsselwert für sichtbare Überlagerungsflächen.
DDCKEYCAPS_SRCOVERLAYYUV Unterstützt das Überlagern mithilfe der Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für YUV-Farben.

dwFXCaps

Geben Sie die Dehnungs- und Effektfunktionen des Treibers an. Der Treiber sollte das entsprechende DDFXCAPS_Xxx-Bit für jede funktion festlegen, die er unterstützt.

Flag Bedeutung
DDFXCAPS_BLTARITHSTRETCHY Verwendet arithmetische Operationen anstelle von Pixelverdopplungstechniken, um Oberflächen während eines Blit-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 Blit-Vorgangs zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf und funktioniert nur für ganzzahlige Dehnungen (x1, x2 usw.).
DDFXCAPS_BLTMIRRORLEFTRIGHT Unterstützt die Spiegelung von links nach rechts in einem Blit-Vorgang.
DDFXCAPS_BLTMIRRORUPDOWN Unterstützt die Spiegelung von oben nach unten in einem Blit-Vorgang.
DDFXCAPS_BLTROTATION Unterstützt die beliebige Drehung in einem Blit-Vorgang. Wenn dieses Funktionsbit vom Treiber für Windows 2000 oder höher festgelegt wird, ist DirectDraw deaktiviert.
DDFXCAPS_BLTROTATION90 Unterstützt 90-Grad-Drehungen in einem Blit-Vorgang. Wenn dieses Funktionsbit vom Treiber für Windows 2000 oder höher festgelegt wird, ist DirectDraw deaktiviert.
DDFXCAPS_BLTSHRINKX Unterstützt das beliebige Verkleinern einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSHRINKXN Unterstützt das Verkleinern von ganzen Zahlen (x1, x2 usw.) einer Fläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSHRINKY Unterstützt das beliebige Verkleinern einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSHRINKYN Unterstützt das Verkleinern von ganzen Zahlen (x1, x2 usw.) einer Fläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSTRETCHX Unterstützt die beliebige Dehnung einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSTRETCHXN Unterstützt ganzzahlige Dehnung (x1, x2 usw.) einer Oberfläche entlang der x-Achse (horizontal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSTRETCHY Unterstützt die beliebige Dehnung einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_BLTSTRETCHYN Unterstützt ganzzahlige Dehnung (x1, x2 usw.) einer Oberfläche entlang der y-Achse (vertikal). Dieses Flag ist nur für Blitvorgänge gültig.
DDFXCAPS_OVERLAYARITHSTRETCHY Verwendet arithmetische Operationen anstelle von Pixelverdopplungstechniken, um Oberflächen während eines Überlagerungsvorgangs zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf.
DDFXCAPS_OVERLAYARITHSTRETCHYN Verwendet arithmetische Operationen anstelle von Pixelverdopplungstechniken, um Oberflächen während eines Überlagerungsvorgangs zu strecken und zu verkleinern. Tritt entlang der y-Achse (vertikal) auf und funktioniert nur für ganzzahlige Dehnungen (x1, x2 usw.).
DDFXCAPS_OVERLAYMIRRORLEFTRIGHT Unterstützt die Spiegelung von Überlagerungen um 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 das Verkleinern von ganzen Zahlen (x1, x2 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 beliebige 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 das Verkleinern von ganzen Zahlen (x1, x2 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 Strecken verfügbar ist.
DDFXCAPS_OVERLAYSTRETCHXN Unterstützt ganzzahlige Dehnung (x1, x2 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 Strecken 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 Strecken verfügbar ist.
DDFXCAPS_OVERLAYSTRETCHYN Unterstützt ganzzahlige Dehnung (x1, x2 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 Strecken verfügbar ist.

dwFXAlphaCaps

Dieser Member und seine Flags sind veraltet und sollten nicht vom Treiber verwendet werden.

dwPalCaps

Geben Sie die Palettenfunktionen des Treibers an. Der Treiber sollte das entsprechende DDPCAPS_Xxx-Bit für jede funktion festlegen, die er unterstützt. Die DDPCAPS_Xxx-Flags sind in ddraw.h definiert. Die DirectDraw-Runtime ignoriert diese Funktionen derzeit.

dwSVCaps

Geben Sie die Stereo-Vision-Funktionen des Treibers an. Der Treiber sollte das entsprechende DDSVCAPS_Xxx-Bit für jede funktion festlegen, die er unterstützt.

Flag Bedeutung
DDSVCAPS_ENIGMA Die Stereoansicht erfolgt mithilfe der Enigma-Codierung.
DDSVCAPS_FLICKER Die Stereoansicht wird durch hochfrequentes Flimmern erreicht.
DDSVCAPS_REDBLUE Die Stereoansicht wird erreicht, wenn der Betrachter das Bild durch rote und blaue Filter über das linke und rechte Auge betrachtet. Alle Bilder müssen ihre Farbräume für diesen Prozess anpassen.
DDSVCAPS_SPLIT Die Stereoansicht erfolgt mit Split-Screen-Technologie.

dwAlphaBltConstBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwAlphaBltPixelBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwAlphaBltSurfaceBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwAlphaOverlayConstBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwAlphaOverlayPixelBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwAlphaOverlaySurfaceBitDepths

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwZBufferBitDepths

Gibt ein Flag an, das die vom Treiber unterstützten Z-Puffertiefen angibt. Dies kann einen der folgenden Werte annehmen:

Flag Bedeutung
DDBD_8 Der Treiber unterstützt einen 8-Tb-Tiefenpuffer.
DDBD_16 Der Treiber unterstützt einen 16-Tb-Tiefenpuffer.
DDBD_24 Der Treiber unterstützt einen 24-Tb-Tiefenpuffer.
DDBD_32 Der Treiber unterstützt einen 32-Tb-Tiefenpuffer.

dwVidMemTotal

Gibt die Gesamtmenge des Anzeigespeichers in Bytes an.

dwVidMemFree

Gibt die Anzahl der Bytes des freien Anzeigespeichers an. Der Treiber legt diesen Member einmal während der Initialisierung auf denselben Wert fest, den er im dwVidMemTotal-Element zurückgibt. DirectDraw aktualisiert es jedes Mal, wenn die Anwendung eine Speicherzuordnung durchführt.

dwMaxVisibleOverlays

Gibt die maximale Anzahl sichtbarer Überlagerungen an.

dwCurrVisibleOverlays

Gibt die aktuelle Anzahl sichtbarer Überlagerungen an.

dwNumFourCCCodes

Gibt die Anzahl von FOURCC-Codes an, die der Treiber unterstützt.

dwAlignBoundarySrc

Gibt die Quellrechteckausrichtung an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss der obere linke Koordinatenwert des Überlagerungsquellrechtecks ein Vielfaches von dwAlignBoundarySrc sein.

dwAlignSizeSrc

Gibt die Größe des Quellrechtecks in Bytes an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss die Breite des Überlagerungsquellrechtecks ein Vielfaches von dwAlignSizeSrc sein.

dwAlignBoundaryDest

Gibt die Zielrechteckausrichtung an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss der obere linke Koordinatenwert des Zielpunkts ein Vielfaches von dwAlignBoundaryDest sein.

dwAlignSizeDest

Gibt die Bytegröße des Zielrechtecks an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss die Breite des Überlagerungszielrechtecks ein Vielfaches von dwAlignSizeDest sein.

dwAlignStrideAlign

Für die Systemverwendung reserviert und sollte vom Treiber ignoriert werden.

dwRops[DD_ROP_SPACE]

Gibt ein Array von DD_ROP_SPACE DWORDs an, die zusammen Flags enthalten können, um die vom Treiber unterstützten ROPs anzugeben. Der Treiber sollte das Bitfeld für jeden entsprechenden ROP festlegen, den er unterstützt. Informationen zu ROPs finden Sie in der Microsoft Windows SDK-Dokumentation.

ddsCaps

Gibt eine DDSCAPS-Struktur an, die die Vom Treiber unterstützten Oberflächentypen beschreibt.

dwMinOverlayStretch

Gibt den minimalen Überlagerungs-Stretchfaktor multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden. Der Anzeigetreiber muss den Mindestfaktor auf das tatsächliche Minimum festlegen, auf das die Grafikhardware die Überlagerung verkleinern kann. Wenn die Grafikhardware keine Mindesteinschränkung aufweist, legen Sie auf 1 fest.

dwMaxOverlayStretch

Gibt den maximalen Überlagerungs-Stretchfaktor multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden. Der Anzeigetreiber muss den maximalen Faktor auf das tatsächliche Maximum festlegen, auf das die Grafikhardware das Overlay strecken kann. Wenn die Grafikhardware keine maximale Einschränkung aufweist, legen Sie auf 32000 fest.

dwMinLiveVideoStretch

Gibt den minimalen Stretchfaktor für Livevideos multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden.

dwMaxLiveVideoStretch

Gibt den maximalen Stretchfaktor für Livevideos multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden.

dwMinHwCodecStretch

Gibt den minimalen Stretchfaktor des Hardwarecodecs multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden.

dwMaxHwCodecStretch

Gibt den maximalen Stretchfaktor des Hardwarecodecs multipliziert mit 1000 an. Ein Faktor von 1,3 sollte beispielsweise als 1300 gespeichert werden.

dwReserved1

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwReserved2

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwReserved3

Ist für das System reserviert. Der Treiber sollte diesen Member ignorieren.

dwSVBCaps

Gibt eine Reihe von Flags an, die die treiberspezifischen Funktionen für system-memory-to-display-memory blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCAPS_Xxx-Flags (siehe dwCaps-Member ) angeben, um die Typen von Blit-Vorgängen anzugeben, die er beim Slitting aus dem Systemspeicher zum Anzeigen des Arbeitsspeichers unterstützt.

dwSVBCKeyCaps

Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für System-Memory-to-Display-Memory-Blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCKEYCAPS_Xxx-Flags (siehe dwCKeyCaps-Member ) angeben, um die Typen von Farbschlüsselvorgängen anzugeben, die beim Durchschneiden aus dem Systemspeicher unterstützt werden, um den Arbeitsspeicher anzuzeigen.

dwSVBFXCaps

Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für System-Memory-to-Display-Memory-Blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDFXCAPS_Xxx-Flags (siehe dwFXCaps-Member ) angeben, um die Arten von Effekten anzugeben, die er unterstützt, wenn er vom Systemspeicher zum Anzeigen des Arbeitsspeichers abweicht.

dwSVBRops[DD_ROP_SPACE]

Gibt ein Array von DD_ROP_SPACE DWORDs an, die zusammen Flags enthalten können, um die ROPs anzugeben, die der Treiber beim Ausführen von System-Memory-to-Display-Memory-Blits unterstützt. Der Treiber sollte das Bitfeld für jeden entsprechenden ROP festlegen, den er unterstützt. Informationen zu ROPs finden Sie in der Microsoft Windows SDK-Dokumentation.

dwVSBCaps

Gibt eine Reihe von Flags an, die treiberspezifische Funktionen für display-memory-to-system-memory blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCAPS_Xxx-Flags (siehe dwCaps-Member ) angeben, um die Typen von Blit-Vorgängen anzugeben, die er unterstützt, wenn vom Anzeigespeicher in den Systemspeicher eingeblendet wird.

dwVSBCKeyCaps

Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für display-memory-to-system-memory blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCKEYCAPS_Xxx-Flags (siehe dwCKeyCaps-Member ) angeben, um die Typen von Farbschlüsselvorgängen anzugeben, die beim Durchschneiden vom Anzeigespeicher in den Systemspeicher unterstützt werden.

dwVSBFXCaps

Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für Display-Memory-to-System-Memory-Blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDFXCAPS_Xxx-Flags (siehe dwFXCaps-Member ) angeben, um die Arten von Effekten anzugeben, die er unterstützt, wenn er vom Anzeigespeicher in den Systemspeicher unterteilt wird.

dwVSBRops[DD_ROP_SPACE]

Gibt ein Array von DD_ROP_SPACE DWORDs an, die zusammen Flags enthalten können, um die ROPs anzugeben, die der Treiber beim Ausführen von Display-Memory-to-System-Memory-Blits unterstützt. Der Treiber sollte das Bitfeld für jeden entsprechenden ROP festlegen, den er unterstützt. Informationen zu ROPs finden Sie in der Dokumentation zum Windows SDK.

dwSSBCaps

Gibt eine Reihe von Flags an, die treiberspezifische Funktionen für Systemspeicher-zu-System-Speicher-Blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCAPS_Xxx-Flags (siehe dwCaps-Member ) angeben, um die Typen von Blit-Vorgängen anzugeben, die er unterstützt, wenn vom Systemspeicher in den Systemspeicher eingeteilt wird.

dwSSBCKeyCaps

Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für Systemspeicher-zu-System-Speicherblits angeben. Der Treiber sollte bitweise oder die entsprechenden DDCKEYCAPS_Xxx-Flags (siehe dwCKeyCaps-Member ) angeben, um die Typen von Farbschlüsselvorgängen anzugeben, die er unterstützt, wenn vom Systemspeicher in den Systemspeicher eingeteilt wird.

dwSSBFXCaps

Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für Systemspeicher-zu-System-Arbeitsspeicher-Blits angeben. Der Treiber sollte bitweise oder die entsprechenden DDFXCAPS_Xxx-Flags (siehe dwFXCaps-Member ) angeben, um die Typen von Effekten anzugeben, die er unterstützt, wenn er vom Systemspeicher in den Systemspeicher unterteilt wird.

dwSSBRops[DD_ROP_SPACE]

Gibt ein Array von DD_ROP_SPACE DWORDs an, die zusammen Flags enthalten können, um die ROPs anzugeben, die der Treiber beim Ausführen von System-Memory-to-System-Memory-Blits unterstützt. Der Treiber sollte das Bitfeld für jeden entsprechenden ROP festlegen, den er unterstützt. Informationen zu ROPs finden Sie in der Dokumentation zum Windows SDK.

dwMaxVideoPorts

Gibt die maximale Anzahl von verwendbaren VPE-Objekten an.

dwCurrVideoPorts

Gibt die aktuelle Anzahl der verwendeten VPE-Objekte an. Der Treiber muss diesen Member nicht ausfüllen, da er von DirectDraw festgelegt wird.

dwSVBCaps2

Gibt zusätzliche treiberspezifische Funktionen für System-Memory-to-Display-Memory-Blits an. Gültige Flags sind mit den blit-bezogenen Flags identisch, die mit dem dwCaps2-Element verwendet werden.

Hinweise

Dieser Abschnitt enthält die DirectDraw-Treiberstruktur, deren Name die Form DDCORECAPS hat, die unter Windows 98/Me verwendet wird. Diese Struktur ist identisch mit der Struktur, deren Name das Formular DDNTCORECAPS hat, das unter Windows 2000 und höheren Versionen verwendet wird. Die Includedatei dx95type.h enthält einen Typ, der von DDNTCORECAPS zu DDCORECAPS definiert wird.

Diese Struktur spiegelt die ersten Einträge der DDCAPS-Struktur wieder, hat jedoch eine feste Größe und wächst nicht wie DDCAPS.

Der Treiber initialisiert DDCORECAPS, wenn er die anderen Member der DD_HALINFO-Struktur in seiner DrvGetDirectDrawInfo-Struktur initialisiert. Die DirectDraw-Runtime kann einige Member aktualisieren.

DirectDraw fordert zusätzliche Treiberfunktionen an, indem die Funktion DdGetDriverInfo aufgerufen wird, die auch in der DD_HALINFO-Struktur zurückgegeben wird.

Anforderungen

Anforderung Wert
Header ddrawi.h (einschließen ddrawi.h)