DEVINFO-Struktur (winddi.h)

Die DEVINFO-Struktur stellt der Grafik-Engine Informationen über den Treiber und seinen privaten PDEV bereit.

Syntax

typedef struct tagDEVINFO {
  FLONG    flGraphicsCaps;
  LOGFONTW lfDefaultFont;
  LOGFONTW lfAnsiVarFont;
  LOGFONTW lfAnsiFixFont;
  ULONG    cFonts;
  ULONG    iDitherFormat;
  USHORT   cxDither;
  USHORT   cyDither;
  HPALETTE hpalDefault;
  FLONG    flGraphicsCaps2;
} DEVINFO, *PDEVINFO;

Member

flGraphicsCaps

Ist eine Reihe von Flags, die grafikfunktionen des Grafiktreibers und/oder seiner Hardware beschreiben. Diese Flags sind in der folgenden Tabelle definiert.

lfDefaultFont

Eine erweiterte logische Schriftartstruktur, die die Standardschriftart für ein Gerät angibt. Weitere Informationen zu dieser Struktur finden Sie unter EXTLOGFONT in der Microsoft Windows SDK-Dokumentation.

lfAnsiVarFont

Eine erweiterte logische Schriftartstruktur, die die Standardschriftart mit variabler Tonhöhe für ein Gerät angibt. Weitere Informationen zu dieser Struktur finden Sie unter EXTLOGFONT in der Windows SDK-Dokumentation.

lfAnsiFixFont

Ist eine erweiterte logische Schriftartstruktur, die die Standardschriftart (monospaced) für ein Gerät angibt. Weitere Informationen zu dieser Struktur finden Sie unter EXTLOGFONT in der Windows SDK-Dokumentation.

cFonts

Gibt die Anzahl der Geräteschriftarten an. GDI geht davon aus, dass das Gerät Text mit dieser Anzahl von Schriftarten auf eigenen Oberflächen zeichnen kann und dass der Treiber Metrikinformationen zu den Schriftarten bereitstellen kann. Wenn der Treiber cFonts auf -1 festlegt, wartet GDI, bis Schriftarten benötigt werden, um den Treiber nach der tatsächlichen Anzahl von Schriftarten abzufragen, die er bei einem Aufruf von DrvQueryFont unterstützt.

iDitherFormat

Gibt das Format der Bitmap an. Dieser Parameter gibt an, wie viele Bits von Farbinformationen pro Pixel angefordert werden, und muss einer der folgenden Werte sein:

cxDither

cyDither

Geben Sie die Dimensionen eines ditherierten Pinsels an. Wenn diese Member ungleich null sind, kann das Gerät einen ditherierten Pinsel für eine bestimmte RGB-Farbe erstellen.

hpalDefault

Handle mit der Standardpalette für das Gerät. Der Treiber sollte die Palette durch Aufrufen von EngCreatePalette erstellen. Der Treiber ordnet einem Gerät eine Palette zu, indem er dieses Handle an GDI zurückgibt.

flGraphicsCaps2

Ist ein Satz von Flags, die zusätzliche Grafikfunktionen des Gerätetreibers beschreiben. Diese Flags sind in der folgenden Tabelle definiert.

Hinweise

Die DrvEnablePDEV-Funktion des Treibers füllt eine DEVINFO-Struktur aus. Der Treiber sollte nur die Member festlegen, die für ihn relevant sind. Diese Struktur wird von GDI null initialisiert, bevor DrvEnablePDEV aufgerufen wird. Anwendungen haben keinen direkten Zugriff auf diese Struktur.

Wenn ein Treiber GCAPS2_JPEGSRC oder GCAPS2_PNGSRC in flGraphicsCaps2 festlegt, gelten die folgenden Regeln:

• Der Treiber muss eine DrvQueryDeviceSupport-Funktion bereitstellen.
• Jede treiberdefinierte Grafik-DDI-Funktion, die eine SURFOBJ-Struktur als Eingabe empfängt, muss entweder das komprimierte Format unterstützen oder einen Fehlercode zurückgeben können. Im Fall von Druckertreibern muss der Treiber in der Lage sein, eine der folgenden Aufgaben auszuführen, um das komprimierte Format zu unterstützen:
  • Wenn das Druckgerät das komprimierte JPEG/PNG-Format verarbeiten kann, sollte der Druckertreiber das komprimierte Format an seine PDL-Ausgabe (Page Description Language) übergeben.
  • Wenn das Druckgerät das komprimierte JPEG/PNG-Format nicht verarbeiten kann, muss der Druckertreiber zunächst das komprimierte JPEG/PNG-Format in ein anderes Bildformat konvertieren, das das Druckgerät verarbeiten kann. Der Druckertreiber kann dann die Bildinformationen in der PDL-Ausgabe des Treibers zur Verfügung stellen.
    Hinweis Bei der Konvertierung von JPEG/PNG in das Bitmapformat darf der Druckertreiber keine GDI-Funktionen verwenden. Beispielsweise kann der Treiber stattdessen die Windows Imaging Component(WIC)-APIs verwenden, um die Konvertierung durchzuführen.
     
• Der Treiber muss in der Lage sein, komplexe Clipbereiche für Bilder zu verarbeiten, die das komprimierte Format verwenden.
• Für treiberdefinierte Grafik-DDI-Funktionen, die ein ROP4-Eingabeargument erhalten, wird nur 0xCCCC mit JPEG- und PNG-Formaten verwendet.

Anforderungen

Weitere Informationen

DrvEnablePDEV

DrvQueryFont

DrvRealizeBrush

DrvTextOut