GetDeviceCaps-Funktion (wingdi.h)

Artikel
03/13/2024

Die GetDeviceCaps-Funktion ruft gerätespezifische Informationen für das angegebene Gerät ab.

Syntax

int GetDeviceCaps(
  [in] HDC hdc,
  [in] int index
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] index

Das zurückzugebende Element. Dieser Parameter kann einen der folgenden Werte annehmen.

Index

Bedeutung

DRIVERVERSION

Die Gerätetreiberversion.

TECHNOLOGIE

Gerätetechnologie. Es kann sich um einen der folgenden Werte handeln.

DT_PLOTTER	Vektorplotter
DT_RASDISPLAY	Rasteranzeige
DT_RASPRINTER	Rasterdrucker
DT_RASCAMERA	Rasterkamera
DT_CHARSTREAM	Zeichendatenstrom
DT_METAFILE	Metafile
DT_DISPFILE	Datei anzeigen

Wenn der hdc-Parameter ein Handle für den DC einer erweiterten Metadatei ist, ist die Gerätetechnologie die des Geräts, auf das verwiesen wird, wie für die CreateEnhMetaFile-Funktion angegeben. Verwenden Sie die GetObjectType-Funktion , um zu bestimmen, ob es sich um einen erweiterten Metadatei-DC handelt.

HORZSIZE

Breite des physischen Bildschirms in Millimetern.

VERTSIZE

Höhe des physischen Bildschirms in Millimetern.

HORZRES

Breite des Bildschirms in Pixel; oder bei Druckern die Breite des druckbaren Bereichs der Seite in Pixel.

VERTRES

Höhe des Bildschirms in Rasterlinien; oder bei Druckern die Höhe des druckbaren Bereichs der Seite in Pixel.

LOGPIXELSX

Die Anzahl der Pixel pro logischem Zoll entlang der Bildschirmbreite. In einem System mit mehreren Anzeigemonitoren ist dieser Wert für alle Monitore gleich.

LOGPIXELSY

Anzahl der Pixel pro logischem Zoll entlang der Bildschirmhöhe. In einem System mit mehreren Anzeigemonitoren ist dieser Wert für alle Monitore gleich.

BITSPIXEL

Anzahl der benachbarten Farbbits für jedes Pixel.

FLUGZEUGE

Anzahl der Farbebenen.

NUMBRUSHES

Anzahl gerätespezifischer Pinsel.

NUMPENS

Anzahl gerätespezifischer Stifte.

NUMFONTS

Anzahl gerätespezifischer Schriftarten.

NUMCOLORS

Anzahl der Einträge in der Farbtabelle des Geräts, wenn das Gerät eine Farbtiefe von nicht mehr als 8 Bit pro Pixel aufweist. Bei Geräten mit größeren Farbtiefen wird -1 zurückgegeben.

ASPECTX

Relative Breite eines Gerätepixels, das für das Zeichnen von Linien verwendet wird.

ASPEKT

Relative Höhe eines Gerätepixels, das zum Zeichnen von Linien verwendet wird.

ASPECTXY

Diagonale Breite des Gerätepixels, das zum Zeichnen von Linien verwendet wird.

PDEVICESIZE

Reserviert.

CLIPCAPS

Flag, das die Abschneidefunktionen des Geräts angibt. Wenn das Gerät ein Rechteck ausschneiden kann, ist es 1. Andernfalls ist der Wert 0.

SIZEPALETTE

Anzahl der Einträge in der Systempalette. Dieser Index ist nur gültig, wenn der Gerätetreiber das RC_PALETTE Bit im RASTERCAPS-Index festlegt und nur verfügbar ist, wenn der Treiber mit 16-Bit-Windows kompatibel ist.

NUMRESERVED

Anzahl der reservierten Einträge in der Systempalette. Dieser Index ist nur gültig, wenn der Gerätetreiber das RC_PALETTE Bit im RASTERCAPS-Index festlegt und nur verfügbar ist, wenn der Treiber mit 16-Bit-Windows kompatibel ist.

COLORRES

Tatsächliche Farbauflösung des Geräts in Bits pro Pixel. Dieser Index ist nur gültig, wenn der Gerätetreiber das RC_PALETTE Bit im RASTERCAPS-Index festlegt und nur verfügbar ist, wenn der Treiber mit 16-Bit-Windows kompatibel ist.

PHYSICALWIDTH

Für Druckgeräte: die Breite der physischen Seite in Geräteeinheiten. Ein Drucker, der mit 600 dpi auf 8,5 x11 Zoll Papier drucken soll, weist beispielsweise einen Physischen Breitenwert von 5100 Geräteeinheiten auf. Beachten Sie, dass die physische Seite fast immer größer als der druckbare Bereich der Seite und nie kleiner ist.

PHYSICALHEIGHT

Für Druckgeräte: Die Höhe der physischen Seite in Geräteeinheiten. Beispielsweise weist ein Drucker, der mit 600 dpi auf 8,5 x 11 Zoll Papier drucken soll, einen physischen Höhenwert von 6600 Geräteeinheiten auf. Beachten Sie, dass die physische Seite fast immer größer als der druckbare Bereich der Seite und nie kleiner ist.

PHYSICALOFFSETX

Für Druckgeräte: Der Abstand vom linken Rand der physischen Seite zum linken Rand des druckbaren Bereichs in Geräteeinheiten. Ein Drucker, der beispielsweise mit 600 dpi auf 8,5 x 11 Zoll Papier drucken soll, das nicht auf dem linken 0,25 Zoll Papier drucken kann, verfügt über einen horizontalen physischen Offset von 150 Geräteeinheiten.

PHYSICALOFFSETY

Für Druckgeräte: Der Abstand vom oberen Rand der physischen Seite zum oberen Rand des druckbaren Bereichs in Geräteeinheiten. Beispielsweise verfügt ein Drucker, der mit 600 dpi auf 8,5 x 11 Zoll Papier drucken soll, das nicht auf das oberste 0,5-Zoll-Papier drucken kann, einen vertikalen physischen Offset von 300 Geräteeinheiten.

VREFRESH

Für Anzeigegeräte: die aktuelle vertikale Aktualisierungsrate des Geräts in Zyklen pro Sekunde (Hz).

Der Wert der vertikalen Aktualisierungsrate von 0 oder 1 stellt die Standardaktualisierungsrate der Anzeigehardware dar. Diese Standardrate wird in der Regel durch Schalter auf einer Anzeige Karte oder einer Computerplatine oder durch ein Konfigurationsprogramm festgelegt, das keine Anzeigefunktionen wie ChangeDisplaySettings verwendet.

SCALINGFACTORX

Skalierungsfaktor für die x-Achse des Druckers.

SCALINGFACTORY

Skalierungsfaktor für die y-Achse des Druckers.

BLTALIGNMENT

Bevorzugte horizontale Zeichnungsausrichtung, ausgedrückt als Vielfaches von Pixeln. Um eine optimale Zeichnungsleistung zu erzielen, sollten Fenster horizontal auf ein Vielfaches dieses Werts ausgerichtet werden. Der Wert 0 gibt an, dass das Gerät beschleunigt wird und eine beliebige Ausrichtung verwendet werden kann.

SHADEBLENDCAPS

Wert, der die Schattierungs- und Mischfunktionen des Geräts angibt. Weitere Kommentare finden Sie unter Hinweise.

SB_CONST_ALPHA	Verarbeitet das SourceConstantAlpha-Element der BLENDFUNCTION-Struktur , auf das der blendFunction-Parameter der AlphaBlend-Funktion verweist.
SB_GRAD_RECT	Kann GradientFill-Rechtecke ausführen.
SB_GRAD_TRI	In der Lage, GradientFill-Dreiecke zu machen.
SB_NONE	Das Gerät unterstützt keine dieser Funktionen.
SB_PIXEL_ALPHA	Kann Alpha pro Pixel in AlphaBlend verarbeiten.
SB_PREMULT_ALPHA	In der Lage, vormultipliziertes Alpha in AlphaBlend zu verarbeiten.

RASTERCAPS

Wert, der die Rasterfunktionen des Geräts angibt, wie in der folgenden Tabelle gezeigt.

RC_BANDING	Erfordert Bandunterstützung.
RC_BITBLT	Kann Bitmaps übertragen.
RC_BITMAP64	Kann Bitmaps unterstützen, die größer als 64 KB sind.
RC_DI_BITMAP	Unterstützt die Funktionen SetDIBits und GetDIBits .
RC_DIBTODEV	Kann die SetDIBitsToDevice-Funktion unterstützen.
RC_FLOODFILL	In der Lage, Flutfüllungen durchzuführen.
RC_PALETTE	Gibt ein palettenbasiertes Gerät an.
RC_SCALING	Skalierungsfähig.
RC_STRETCHBLT	Kann die StretchBlt-Funktion ausführen.
RC_STRETCHDIB	Kann die StretchDIBits-Funktion ausführen.

CURVECAPS

Wert, der die Kurvenfunktionen des Geräts angibt, wie in der folgenden Tabelle gezeigt.

CC_NONE	Das Gerät unterstützt keine Kurven.
CC_CHORD	Das Gerät kann Akkordbögen zeichnen.
CC_CIRCLES	Das Gerät kann Kreise zeichnen.
CC_ELLIPSES	Das Gerät kann Auslassungspunkte zeichnen.
CC_INTERIORS	Das Gerät kann Interieurs zeichnen.
CC_PIE	Das Gerät kann Kreis-Wedges zeichnen.
CC_ROUNDRECT	Das Gerät kann abgerundete Rechtecke zeichnen.
CC_STYLED	Das Gerät kann rahmenformatiert zeichnen.
CC_WIDE	Das Gerät kann breite Rahmen zeichnen.
CC_WIDESTYLED	Das Gerät kann Rahmen zeichnen, die breit und formatiert sind.

LINECAPS

Wert, der die Zeilenfunktionen des Geräts angibt, wie in der folgenden Tabelle gezeigt:

LC_NONE	Das Gerät unterstützt keine Zeilen.
LC_INTERIORS	Das Gerät kann Interieurs zeichnen.
LC_MARKER	Das Gerät kann einen Marker zeichnen.
LC_POLYLINE	Das Gerät kann eine Polylinie zeichnen.
LC_POLYMARKER	Das Gerät kann mehrere Marker zeichnen.
LC_STYLED	Das Gerät kann linienartige Linien zeichnen.
LC_WIDE	Das Gerät kann breite Linien zeichnen.
LC_WIDESTYLED	Das Gerät kann Linien zeichnen, die breit und formatiert sind.

POLYGONALCAPS

Wert, der die Polygonfunktionen des Geräts angibt, wie in der folgenden Tabelle gezeigt.

PC_NONE	Das Gerät unterstützt keine Polygone.
PC_INTERIORS	Das Gerät kann Interieurs zeichnen.
PC_POLYGON	Das Gerät kann Polygone mit alternativer Füllung zeichnen.
PC_RECTANGLE	Das Gerät kann Rechtecke zeichnen.
PC_SCANLINE	Das Gerät kann eine einzelne Scanlinie zeichnen.
PC_STYLED	Das Gerät kann rahmenformatiert zeichnen.
PC_WIDE	Das Gerät kann breite Rahmen zeichnen.
PC_WIDESTYLED	Das Gerät kann Rahmen zeichnen, die breit und formatiert sind.
PC_WINDPOLYGON	Das Gerät kann Wickel-Füllpolygons zeichnen.

TEXTCAPS

Wert, der die Textfunktionen des Geräts angibt, wie in der folgenden Tabelle gezeigt.

TC_OP_CHARACTER	Das Gerät ist in der Lage, die Genauigkeit der Zeichenausgabe zu verwenden.
TC_OP_STROKE	Das Gerät kann Strichausgabegenauigkeit aufweisen.
TC_CP_STROKE	Das Gerät kann Strichclipgenauigkeit aufweisen.
TC_CR_90	Das Gerät kann 90-Grad-Zeichendrehung ausführen.
TC_CR_ANY	Das Gerät kann jede Zeichenrotation durchführen.
TC_SF_X_YINDEP	Das Gerät kann unabhängig in x- und y-Richtung skaliert werden.
TC_SA_DOUBLE	Das Gerät kann das Zeichen für die Skalierung verdoppeln.
TC_SA_INTEGER	Das Gerät verwendet nur ganzzahlige Vielfache für die Zeichenskalierung.
TC_SA_CONTIN	Das Gerät verwendet ein beliebiges Vielfaches für die exakte Zeichenskalierung.
TC_EA_DOUBLE	Das Gerät kann Zeichen mit doppelter Gewichtung zeichnen.
TC_IA_ABLE	Das Gerät kann kursiv sein.
TC_UA_ABLE	Das Gerät kann unterstrichen werden.
TC_SO_ABLE	Das Gerät kann Strikeouts zeichnen.
TC_RA_ABLE	Das Gerät kann Rasterschriftarten zeichnen.
TC_VA_ABLE	Das Gerät kann Vektorschriftarten zeichnen.
TC_RESERVED	Reserviert; muss null sein.
TC_SCROLLBLT	Das Gerät kann mit einer Bitblockübertragung nicht scrollen. Beachten Sie, dass diese Bedeutung möglicherweise das Gegenteil von dem ist, was Sie erwarten.

COLORMGMTCAPS

Wert, der die Farbverwaltungsfunktionen des Geräts angibt.

CM_CMYK_COLOR	Das Gerät kann das ICC-Farbprofil im CMYK-Farbraum akzeptieren.
CM_DEVICE_ICM	Das Gerät kann ICM entweder auf dem Gerätetreiber oder auf dem Gerät selbst ausführen.
CM_GAMMA_RAMP	Gerät unterstützt GetDeviceGammaRamp und SetDeviceGammaRamp
CM_NONE	Das Gerät unterstützt ICM nicht.

Rückgabewert

Der Rückgabewert gibt den Wert des gewünschten Elements an.

Wenn nIndex BITSPIXEL ist und das Gerät über 15bpp oder 16bpp verfügt, ist der Rückgabewert 16.

Hinweise

Wenn nIndex SHADEBLENDCAPS ist:

Für einen Drucker gibt GetDeviceCaps alles zurück, was der Drucker meldet.
Für ein Anzeigegerät sind alle Füllvorgänge verfügbar. neben SB_NONE sind die einzigen Rückgabewerte SB_CONST_ALPHA und SB_PIXEL_ALPHA, die angeben, ob diese Vorgänge beschleunigt werden.

Wenn hdc auf einem System mit mehreren Monitoren der Desktop ist, gibt GetDeviceCaps die Funktionen des primären Monitors zurück. Wenn Sie Informationen zu anderen Monitoren benötigen, müssen Sie die Multimonitor-APIs oder CreateDC verwenden, um einen HDC für den Gerätekontext (DC) eines bestimmten Monitors abzurufen.

Hinweis Display1 ist in der Regel der primäre Monitor, aber nicht immer.

GetDeviceCaps stellt die folgenden sechs Indizes anstelle von Drucker-Escapes bereit.

Index	Drucker escape ersetzt
PHYSICALWIDTH	GETPHYSPAGESIZE
PHYSICALHEIGHT	GETPHYSPAGESIZE
PHYSICALOFFSETX	GETPRINTINGOFFSET
PHYSICALOFFSETY	GETPHYSICALOFFSET
SCALINGFACTORX	GETSCALINGFACTOR
SCALINGFACTORY	GETSCALINGFACTOR

HinweisGetDeviceCaps meldet Informationen, die der Anzeigetreiber bereitstellt. Wenn der Anzeigetreiber keine Informationen meldet, berechnet GetDeviceCaps die Informationen basierend auf festen Berechnungen. Wenn der Anzeigetreiber ungültige Informationen meldet, gibt GetDeviceCaps die ungültigen Informationen zurück. Wenn der Anzeigetreiber die Meldung von Informationen ablehnt, berechnet GetDeviceCaps möglicherweise falsche Informationen, da entweder eine feste DPI (96 DPI) oder eine feste Größe (abhängig von den Vom Anzeigetreiber bereitgestellten und nicht bereitgestellten Informationen) angenommen wird. Leider führt ein Anzeigetreiber, der in das Windows Display Driver Model (WDDM) implementiert ist (in Windows Vista eingeführt), dazu, dass GDI die Informationen nicht erhält, sodass GetDeviceCaps die Informationen immer berechnen muss.

Beispiele

Ein Beispiel finden Sie unter Vorbereiten des Druckens.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll