DDCORECAPS-Struktur (ddrawi.h)
Die DDCORECAPS-Struktur gibt die Kernfunktionen des Microsoft DirectDraw-Treibers und seines Geräts an, die über das DirectDraw-Objekt für eine Anwendung 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;
Angehörige
dwSize
Gibt die Größe in Byte dieser DDCORECAPS-Struktur an.
dwCaps
Gibt ein Kennzeichen an, das die Funktionen des Treibers angibt. Der Treiber sollte das entsprechende DDCAPS_Xxx- Bit für jede von ihr unterstützte Funktion festlegen.
| Flagge | Bedeutung |
|---|---|
| DDCAPS_3D | Die Anzeigehardware verfügt über 3D-Beschleunigung. |
| DDCAPS_ALIGNBOUNDARYDEST | DirectDraw unterstützt nur diese Quellrechtecke mit der X-Achse, die an den dwAlignBoundaryDest- Begrenzungen der Oberfläche ausgerichtet ist. |
| DDCAPS_ALIGNBOUNDARYSRC | DirectDraw unterstützt nur die Quellrechtecke mit der X-Achse, die an den dwAlignBoundarySrc Begrenzungen der Oberfläche ausgerichtet ist. |
| DDCAPS_ALIGNSIZEDEST | DirectDraw unterstützt nur die Quellrechtecke, deren X-Achsengrößen in Byte dwAlignSizeDest Vielfachen sind. |
| DDCAPS_ALIGNSIZESRC | DirectDraw unterstützt nur die Quellrechtecke, deren X-Achsengrößen in Bytes dwAlignSizeSrc Vielfachen sind. |
| DDCAPS_ALIGNSTRIDE | DirectDraw erstellt Anzeigespeicheroberflächen, die eine Strideausrichtung aufweisen, die dem wert dwAlignStrideAlign entspricht. |
| DDCAPS_ALPHA | Die Anzeigehardware unterstützt während des Blit-Betriebs einen Alphakanal. |
| DDCAPS_BANKSWITCHED | Die Anzeigehardware ist bankgeschaltet und ist potenziell sehr langsam, wenn der zufällige Zugriff auf den Anzeigespeicher erfolgt. Wenn dieses Funktionsbit vom Microsoft Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert. |
| DDCAPS_BLT | Die Anzeigehardware kann blit-Vorgänge ausführen. |
| DDCAPS_BLTCOLORFILL | Die Anzeigehardware ist in der Lage, farbfüllend mit einem Litter zu füllen. |
| DDCAPS_BLTDEPTHFILL | Die Anzeigehardware ist in der Lage, Z-Puffer mit Tiefenfüllen mit einem Litter zu füllen. |
| DDCAPS_BLTFOURCC | Die Anzeigehardware ist in der Lage, Während des Blit-Betriebs Farbraumkonvertierungen durchzuführen. |
| DDCAPS_BLTQUEUE | Die Anzeigehardware kann asynchrone Blit-Vorgänge ausführen. |
| DDCAPS_BLTSTRETCH | Die Anzeigehardware kann während der Blit-Vorgänge gestreckt werden. |
| DDCAPS_CANBLTSYSMEM | Die Anzeigehardware kann in den Systemspeicher oder aus dem Systemspeicher eingeblendet werden. |
| DDCAPS_CANCLIP | Die Anzeigehardware kann mit Ausschnitten beschnitten werden. |
| DDCAPS_CANCLIPSTRETCHED | Die Anzeigehardware kann beim Stretch-Blitting beschnitten werden. |
| DDCAPS_COLORKEY | Einige Formen von Farbschlüsseln in Überlagerungs- oder Blit-Vorgängen werden unterstützt. Spezifischere Informationen zur Farbschlüsselfunktion finden Sie im dwCKeyCaps Member. |
| DDCAPS_COLORKEYHWASSIST | Der Farbschlüssel wird hardwareunterstü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 jedoch nicht beschneiden. |
| DDCAPS_OVERLAYFOURCC | Die Overlayhardware kann während Überlagerungsvorgängen Farbraumkonvertierungen durchführen. |
| DDCAPS_OVERLAYSTRETCH | Die Überlagerungshardware kann gestreckt werden. |
| DDCAPS_PALETTE | DirectDraw kann DirectDrawPalette-Objekte für mehr als nur die primäre Oberfläche erstellen und 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 wird. |
| DDCAPS_READSCANLINE | Die Anzeigehardware kann die aktuelle Scanzeile zurückgeben. |
| DDCAPS_STEREOVIEW | Die Anzeigehardware verfügt über Stereo-Vision-Funktionen. |
| DDCAPS_VBI | Die Anzeigehardware kann einen vertikal 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 zum Steuern der Schichtung. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert. |
dwCaps2
Geben Sie mehr der Funktionen des Treibers an. Der Treiber sollte die entsprechende DDCAPS2_Xxx Bit für jede von ihr unterstützte Funktion festlegen.
| Flagge | Bedeutung |
|---|---|
| DDCAPS2_AUTOFLIPOVERLAY | Die Überlagerung kann bei jedem Auftreten einer V-Synchronisierung des Hardwarevideoports automatisch auf die nächste Oberfläche in der Flipchain gekippt werden, sodass die Videoporterweiterungen (VPE) Objekt und die Überlagerung das Video ohne CPU-Aufwand zwischenpuffern können. Diese Option ist nur gültig, wenn die Oberfläche Daten vom Hardwarevideoport empfängt. Wenn die Hardware-Videoportdaten nicht interlaced oder nicht intergespeichert sind, wird sie bei jeder V-Synchronisierung gedreht. Wenn die Daten im Arbeitsspeicher interleaviert werden, wird sie auf alle anderen V-Synchronisierungen gekippt. |
| DDCAPS2_CANAUTOGENMIPMAP |
|
| DDCAPS2_CANBOBHARDWARE | Die Overlayhardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen. |
| DDCAPS2_CANBOBINTERLEAVED | Die Überlagerungshardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen, während es im Arbeitsspeicher interleaviert wird, ohne dass Artefakte verursacht werden, 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 nur gültig ist, wenn das Video mindestens 200 Prozent in vertikaler Richtung vergrößert wird. |
| DDCAPS2_CANBOBNONINTERLEAVED | Die Overlayhardware kann jedes Feld eines interlaced Videostreams einzeln anzeigen, ohne dass es ohne spezielle Hardwareunterstützung im Arbeitsspeicher interleaviert wird. Diese Option ist nur gültig, wenn die Oberfläche Daten von einem VPE-Objekt empfängt und nur gültig ist, wenn das Video mindestens 200 Prozent in vertikaler Richtung vergrößert wird. |
| DDCAPS2_CANCALIBRATEGAMMA | Ein Kalibriergerät ist verfügbar, um die Gammahierarchie entsprechend den physikalischen Anzeigeeigenschaften anzupassen, sodass das Ergebnis auf allen kalibrierten Systemen identisch ist. |
| DDCAPS2_CANDROPZ16BIT | 16-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 using software without using a VPE object. |
| 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 Schneiden aller FOURCC Oberfläche auf eine andere Oberfläche des gleichen FOURCC. |
| DDCAPS2_FLIPINTERVAL | Der Treiber reagiert auf die DDFLIP_INTERVAL2, DDFLIP_INTERVAL3 und DDFLIP_INTERVAL4 Flags. |
| DDCAPS2_FLIPNOVSYNC | Der Treiber reagiert auf DDFLIP_FLIPNOVSYNC. |
| DDCAPS2_NO2DDURING3DSCENE | Der Treiber kann 2D-Vorgänge wie DdBlt- oder DdLock- nicht auf allen Oberflächen zwischen Aufrufen der IDirect3DDevice::BeginScene- und IDirect3DDevice::EndScene--Methoden zwischenspeichern. |
| 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 diese Kennzeichnung vorhanden ist, ist auch das DDCAPS2_NONLOCALVIDMEM Flag vorhanden. |
| DDCAPS2_NOPAGELOCKREQUIRED | Der Treiber sollte für Blits mit Systemspeicheroberflächen aufgerufen werden, auch wenn die Systemspeicheroberflächen nicht ausgelagert werden. |
| DDCAPS2_PRIMARYGAMMA | Der Treiber unterstützt ladebare Gammahierarchien 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 erwarten, dass CreateSurface Anforderungen von Anwendungen für Oberflächen empfangen werden, die breiter als die primäre Oberfläche sind. |
dwCKeyCaps
Geben Sie die Farbschlüsselfunktionen von Oberflächen an. Der Treiber sollte die entsprechende DDCKEYCAPS_Xxx Bit für jede von ihr unterstützte Funktion festlegen.
| Flagge | Bedeutung |
|---|---|
| DDCKEYCAPS_DESTBLT | Unterstützt transparente Litting mit einem Farbschlüssel, der die austauschbaren Bits der Zieloberfläche für RGB-Farben identifiziert. |
| DDCKEYCAPS_DESTBLTCLRSPACE | Unterstützt transparente Litting mit einem Farbraum, der die austauschbaren Bits der Zieloberfläche für RGB-Farben identifiziert. |
| DDCKEYCAPS_DESTBLTCLRSPACEYUV | Unterstützt transparente Litting mit einem Farbraum, der die austauschbaren Bits der Zieloberfläche für YUV-Farben identifiziert. |
| DDCKEYCAPS_DESTBLTYUV | Unterstützt transparente Litting mit einem Farbschlüssel, der die austauschbaren Bits der Zieloberfläche für YUV-Farben identifiziert. |
| DDCKEYCAPS_DESTOVERLAY | Unterstützt Überlagerungen 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 die Überlagerung mithilfe von Farbtasten der austauschbaren Bits der Zieloberfläche, die für YUV-Farben überlagert wird. |
| DDCKEYCAPS_NOCOSTOVERLAY | Gibt an, dass es keine Bandbreitenübergänge für die Verwendung des Farbschlüssels mit einer Überlagerung gibt. |
| DDCKEYCAPS_SRCBLT | Unterstützt transparente Litting mithilfe des Farbschlüssels für die Quelle mit dieser Oberfläche für RGB-Farben. |
| DDCKEYCAPS_SRCBLTCLRSPACE | Unterstützt transparente Litting mithilfe eines Farbraums für die Quelle mit dieser Oberfläche für RGB-Farben. |
| DDCKEYCAPS_SRCBLTCLRSPACEYUV | Unterstützt transparente Litting mithilfe eines Farbraums für die Quelle mit dieser Oberfläche für YUV-Farben. |
| DDCKEYCAPS_SRCBLTYUV | Unterstützt transparente Litting mithilfe der Farbtaste für die Quelle mit dieser Oberfläche für YUV-Farben. |
| DDCKEYCAPS_SRCOVERLAY | Unterstützt Überlagerungen mithilfe der Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für RGB-Farben. |
| DDCKEYCAPS_SRCOVERLAYCLRSPACE | Unterstützt die Überlagerung mithilfe eines Farbraums als Quellfarbschlüssel für die Überlagerungsoberfläche für RGB-Farben. |
| DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV | Unterstützt die Überlagerung mithilfe eines Farbraums 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 die Überlagerung mithilfe der Farbtaste für die Quelle mit dieser Überlagerungsoberfläche für YUV-Farben. |
dwFXCaps
Geben Sie die Streckungs- und Effektfunktionen des Treibers an. Der Treiber sollte die entsprechende DDFXCAPS_Xxx- Bit für jede von ihr unterstützte Funktion festlegen.
| Flagge | Bedeutung |
|---|---|
| DDFXCAPS_BLTARITHSTRETCHY | Verwendet arithmetische Vorgänge anstelle von Pixelverdopplungstechniken, um Oberflächen während eines Lit-Vorgangs zu strecken und zu verkleinern. Tritt entlang der Y-Achse (vertikal) auf. |
| DDFXCAPS_BLTARITHSTRETCHYN | Verwendet arithmetische Vorgänge anstelle von Pixelverdopplungstechniken, um Oberflächen während eines Lit-Vorgangs zu strecken und zu verkleinern. Tritt entlang der Y-Achse (vertikal) auf und funktioniert nur für ganzzahlige Streckung (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 eine beliebige Drehung in einem Lit-Vorgang. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert. |
| DDFXCAPS_BLTROTATION90 | Unterstützt 90-Grad-Drehungen in einem Blit-Vorgang. Wenn dieses Funktionsbit vom Windows 2000- oder höher-Treiber festgelegt wird, ist DirectDraw deaktiviert. |
| DDFXCAPS_BLTSHRINKX | Unterstützt die beliebige Verkleinerung einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSHRINKXN | Unterstützt die ganzzahlige Verkleinerung (x1, x2 usw.) einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSHRINKY | Unterstützt die beliebige Verkleinerung einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSHRINKYN | Unterstützt die ganzzahlige Verkleinerung (x1, x2 usw.) einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSTRETCHX | Unterstützt eine beliebige Streckung einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSTRETCHXN | Unterstützt das ganzzahlige Strecken (x1, x2 usw.) einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSTRETCHY | Unterstützt eine beliebige Streckung einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_BLTSTRETCHYN | Unterstützt ganzzahliges Strecken (x1, x2 usw.) einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für blit-Vorgänge gültig. |
| DDFXCAPS_OVERLAYARITHSTRETCHY | Verwendet arithmetische Vorgänge anstelle von Pixelverdoppelungstechniken, um Oberflächen während eines Überlagerungsvorgangs zu strecken und zu verkleinern. Tritt entlang der Y-Achse (vertikal) auf. |
| DDFXCAPS_OVERLAYARITHSTRETCHYN | Verwendet arithmetische Vorgänge anstelle von Pixelverdoppelungstechniken, 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 Streckung (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 die beliebige Verkleinerung einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es gibt nicht an, dass das Verkleinern verfügbar ist. |
| DDFXCAPS_OVERLAYSHRINKXN | Unterstützt die ganzzahlige Verkleinerung (x1, x2 usw.) einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es gibt nicht an, dass das Verkleinern verfügbar ist. |
| DDFXCAPS_OVERLAYSHRINKY | Unterstützt die beliebige Verkleinerung einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es gibt nicht an, dass das Verkleinern verfügbar ist. |
| DDFXCAPS_OVERLAYSHRINKYN | Unterstützt die ganzzahlige Verkleinerung (x1, x2 usw.) einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es gibt nicht an, dass das Verkleinern verfügbar ist. |
| DDFXCAPS_OVERLAYSTRETCHX | Unterstützt eine beliebige Streckung einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es weist nicht darauf hin, dass Streckung verfügbar ist. |
| DDFXCAPS_OVERLAYSTRETCHXN | Unterstützt das ganzzahlige Strecken (x1, x2 usw.) einer Oberfläche entlang der X-Achse (horizontal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es weist nicht darauf hin, dass Streckung verfügbar ist. |
| DDFXCAPS_OVERLAYSTRETCHY | Unterstützt eine beliebige Streckung einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es weist nicht darauf hin, dass Streckung verfügbar ist. |
| DDFXCAPS_OVERLAYSTRETCHYN | Unterstützt ganzzahliges Strecken (x1, x2 usw.) einer Oberfläche entlang der Y-Achse (vertikal). Dieses Kennzeichen ist nur für DDSCAPS_OVERLAY Oberflächen gültig. Diese Kennzeichnung gibt nur die Funktionen einer Oberfläche an; es weist nicht darauf hin, dass Streckung verfügbar ist. |
dwFXAlphaCaps
Dieses Element und seine Flags sind veraltet und sollten nicht vom Treiber verwendet werden.
dwPalCaps
Geben Sie die Palettenfunktionen des Treibers an. Der Treiber sollte den entsprechenden DDPCAPS_Xxx- Bit für jede von ihr unterstützte Funktion festlegen. Die DDPCAPS_Xxx Flags werden in ddraw.hdefiniert. Die DirectDraw-Laufzeit ignoriert diese Funktionen derzeit.
dwSVCaps
Geben Sie die Stereo-Vision-Funktionen des Treibers an. Der Treiber sollte die entsprechende DDSVCAPS_Xxx- Bit für jede unterstützte Funktion festlegen.
| Flagge | Bedeutung |
|---|---|
| DDSVCAPS_ENIGMA | Die Stereoansicht erfolgt mithilfe der Enigma-Codierung. |
| DDSVCAPS_FLICKER | Die Stereoansicht wird mithilfe von Hochfrequenzflimmern erreicht. |
| DDSVCAPS_REDBLUE | Die Stereoansicht wird erreicht, wenn der Betrachter das Bild durch rote und blaue Filter betrachtet, die über den linken und rechten Augen platziert sind. Alle Bilder müssen ihre Farbräume für diesen Prozess anpassen. |
| DDSVCAPS_SPLIT | Die Stereoansicht wird mit split-screen-Technologie erreicht. |
dwAlphaBltConstBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwAlphaBltPixelBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwAlphaBltSurfaceBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwAlphaOverlayConstBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwAlphaOverlayPixelBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwAlphaOverlaySurfaceBitDepths
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwZBufferBitDepths
Gibt ein Flag an, das die vom Treiber unterstützten Z-Puffertiefen angibt. Dabei kann es sich um einen oder mehrere der folgenden Werte handeln:
| Flagge | Bedeutung |
|---|---|
| DDBD_8 | Der Treiber unterstützt einen Tiefenpuffer mit 8 Tb. |
| DDBD_16 | Der Treiber unterstützt einen Tiefenpuffer von 16 Tb. |
| DDBD_24 | Der Treiber unterstützt einen Tiefenpuffer von 24 Tb. |
| DDBD_32 | Der Treiber unterstützt einen Tiefenpuffer von 32 Tb. |
dwVidMemTotal
Gibt die Gesamtmenge des Anzeigespeichers in Bytes an.
dwVidMemFree
Gibt die Anzahl der Bytes des freien Anzeigespeichers an. Der Treiber legt dieses Element einmal während der Initialisierung auf denselben Wert fest, den er im dwVidMemTotal Member zurückgibt. DirectDraw aktualisiert sie jedes Mal, wenn die Anwendung eine Speicherzuweisung durchführt.
dwMaxVisibleOverlays
Gibt die maximale Anzahl sichtbarer Überlagerungen an.
dwCurrVisibleOverlays
Gibt die aktuelle Anzahl der sichtbaren Überlagerungen an.
dwNumFourCCCodes
Gibt die Anzahl der FOURCC- Codes an, die der Treiber unterstützt.
dwAlignBoundarySrc
Gibt die Ausrichtung des Quellrechtecks an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss der obere linke Koordinatenwert des Overlayquellrechtecks ein Vielfaches dwAlignBoundarySrcsein.
dwAlignSizeSrc
Gibt die Größe des Quellrechtecks in Byte an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss die Breite des Overlayquellrechtecks ein Vielfaches von dwAlignSizeSrcsein.
dwAlignBoundaryDest
Gibt die Ausrichtung des Zielrechtecks an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss der obere linke Koordinatenwert des Überlagerungszielrechtecks ein Vielfaches dwAlignBoundaryDest-sein.
dwAlignSizeDest
Gibt die Größe des Zielrechteck-Byte an. Dieses Element kann optional vom Treiber festgelegt werden. Wenn der Treiber dieses Element festlegt, muss die Breite des Überlagerungszielrechtecks ein Vielfaches dwAlignSizeDest-sein.
dwAlignStrideAlign
Reserviert für die Systemverwendung 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 jedes entsprechende ROP festlegen, das unterstützt wird. 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 mit 1000 multipliziert an. Beispielsweise sollte ein Faktor von 1,3 als 1300 gespeichert werden. Der Anzeigetreiber muss den Minimalfaktor auf das tatsächliche Minimum festlegen, auf das die Grafikhardware das Overlay verkleinern kann. Wenn die Grafikhardware keine Mindesteinschränkung aufweist, legen Sie diese auf 1 fest.
dwMaxOverlayStretch
Gibt den maximal multiplizierten Überlagerungsfaktor mit 1000 an. Beispielsweise sollte ein Faktor von 1,3 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 Beschränkung aufweist, legen Sie diese auf 32000 fest.
dwMinLiveVideoStretch
Gibt den minimalen Stretchfaktor für Livevideos mit 1000 multipliziert an. Beispielsweise sollte ein Faktor von 1,3 als 1300 gespeichert werden.
dwMaxLiveVideoStretch
Gibt den maximalen Stretchfaktor für Livevideos mit 1000 multipliziert an. Beispielsweise sollte ein Faktor von 1,3 als 1300 gespeichert werden.
dwMinHwCodecStretch
Gibt den minimalen Stretchfaktor des Hardwarecodecs mit 1000 multipliziert an. Beispielsweise sollte ein Faktor von 1,3 als 1300 gespeichert werden.
dwMaxHwCodecStretch
Gibt den maximalen Stretchfaktor des Hardwarecodecs mit 1000 multipliziert an. Beispielsweise sollte ein Faktor von 1,3 als 1300 gespeichert werden.
dwReserved1
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwReserved2
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element ignorieren.
dwReserved3
Reserviert für die Systemverwendung. Der Treiber sollte dieses Element 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 angeben (siehe das dwCaps Member), um die Typen von Blit-Vorgängen anzugeben, die vom Systemspeicher unterstützt werden, um Speicher anzuzeigen.
dwSVBCKeyCaps
Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für Systemspeicher-zu-Anzeige-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDCKEYCAPS_Xxx Flags angeben (siehe die dwCKeyCaps Member), um die Typen von Farbschlüsselvorgängen anzugeben, die vom Systemspeicher unterstützt werden, um Speicher anzuzeigen.
dwSVBFXCaps
Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für Systemspeicher-zu-Display-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDFXCAPS_Xxx Flags angeben (siehe dwFXCaps Member), um die Typen von Effekten anzugeben, die vom Systemspeicher unterstützt werden, um Speicher anzuzeigen.
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 unterstützt, wenn system-memory-to-display-memory-blits ausgeführt werden. Der Treiber sollte das Bitfeld für jedes entsprechende ROP festlegen, das unterstützt wird. Informationen zu ROPs finden Sie in der Microsoft Windows SDK-Dokumentation.
dwVSBCaps
Gibt eine Reihe von Flags an, die treiberspezifische Funktionen für Anzeigespeicher-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 unterstützt werden, wenn sie vom Anzeigespeicher zum Systemspeicher gelitten werden.
dwVSBCKeyCaps
Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für Anzeigespeicher-zu-System-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDCKEYCAPS_Xxx Flags angeben (siehe die dwCKeyCaps Member), um die Typen von Farbschlüsselvorgängen anzugeben, die beim Ausschneiden vom Anzeigespeicher zum Systemspeicher unterstützt werden.
dwVSBFXCaps
Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für Display-Memory-zu-System-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDFXCAPS_Xxx- Flags (siehe das dwFXCaps Member) angeben, um die Typen von Effekten anzugeben, die vom Bildschirmspeicher zum Systemspeicher unterstützt werden.
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 unterstützt, wenn Anzeigespeicher-zu-System-Speicher-Blits ausgeführt werden. Der Treiber sollte das Bitfeld für jedes entsprechende ROP festlegen, das unterstützt wird. Informationen zu ROPs finden Sie in der Windows SDK-Dokumentation.
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 vom Systemspeicher zum Systemspeicher unterstützt werden.
dwSSBCKeyCaps
Gibt eine Reihe von Flags an, die Treiberfarbschlüsselfunktionen für Systemspeicher-zu-System-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDCKEYCAPS_Xxx Flags angeben (siehe die dwCKeyCaps Member), um die Typen von Farbschlüsselvorgängen anzugeben, die vom Systemspeicher zum Systemspeicher unterstützt werden.
dwSSBFXCaps
Gibt eine Reihe von Flags an, die Treiber-FX-Funktionen für Systemspeicher-zu-System-Speicher-Blits angeben. Der Treiber sollte bitweise ODER die entsprechenden DDFXCAPS_Xxx Flags angeben (siehe dwFXCaps Member), um die Typen von Effekten anzugeben, die vom Systemspeicher zum Systemspeicher unterstützt werden.
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 unterstützt, wenn Systemspeicher-zu-System-Speicher-Blits ausgeführt werden. Der Treiber sollte das Bitfeld für jedes entsprechende ROP festlegen, das unterstützt wird. Informationen zu ROPs finden Sie in der Windows SDK-Dokumentation.
dwMaxVideoPorts
Gibt die maximale Anzahl verwendbarer VPE-Objekte an.
dwCurrVideoPorts
Gibt die aktuelle Anzahl der verwendeten VPE-Objekte an. Der Treiber muss dieses Element nicht ausfüllen, da es von DirectDraw festgelegt wird.
dwSVBCaps2
Gibt zusätzliche treiberspezifische Funktionen für Systemspeicher-zu-Anzeige-Speicher-Blits an. Gültige Flags sind identisch mit den blit-bezogenen Flags, die mit dem dwCaps2 Member verwendet werden.
Bemerkungen
Dieser Abschnitt enthält die DirectDraw-Treiberstruktur, deren Name das Formular DDCORECAPS aufweist, das in Windows 98/Me verwendet wird. Diese Struktur ist identisch mit dem Format DDNTCORECAPS, das in Windows 2000 und höheren Versionen verwendet wird. Die include-Datei dx95type.h enthält einen Typ, der von DDNTCORECAPS zu DDCORECAPS definiert wird.
Diese Struktur spiegelt die ersten Einträge der DDCAPS-Struktur wieder, ist jedoch eine feste Größe und wird nicht vergrößert, da DDCAPS dies tut.
Der Treiber initialisiert DDCORECAPS, wenn es die anderen Elemente der DD_HALINFO Struktur in seiner DrvGetDirectDrawInfo- Struktur initialisiert. Die DirectDraw-Laufzeit aktualisiert möglicherweise einige Member.
DirectDraw fordert zusätzliche Treiberfunktionen an, indem die DdGetDriverInfo Funktion aufgerufen wird, die auch in der DD_HALINFO-Struktur zurückgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ddrawi.h (include Ddrawi.h) |