Freigeben über

DrvDeviceCapabilities-Funktion (winddiui.h)

  • Artikel

Die DrvDeviceCapabilities Funktion einer Druckerschnittstelle gibt angeforderte Informationen zu den Funktionen eines Druckers zurück.

Syntax

DWORD DrvDeviceCapabilities(
                 HANDLE   hPrinter,
  [in]           PWSTR    pszDeviceName,
                 WORD     Capability,
  [out]          PVOID    pOutput,
  [in, optional] PDEVMODE pDevmode
);

Parameter

hPrinter

Vom Anrufer bereitgestellter Druckerhandle.

[in] pszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine Druckernamenzeichenfolge.

Capability

Vom Aufrufer bereitgestellte Bitkennzeichnung, die die angeforderten Informationen angibt. Dies kann eine der Flags sein, die in der folgenden Tabelle aufgeführt sind. (Die Flags werden in der Headerdatei Wingdi.h definiert.)

Flagge Definition
DC_BINADJUST Wird nicht für NT-basierte Betriebssysteme verwendet.
DC_BINNAMES Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 24 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine Zeichenfolge mit Breite und NULL-Zeichenfolge enthalten, die den Namen eines Papierquellcontainers angibt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_BINS Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem WORD-Array füllen soll. Jedes Arrayelement sollte eine DMBIN-Präfixkonstante (oder einen angepassten Wert) enthalten, die einen unterstützten Papierquellcontainer darstellt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_COLLATE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte 1 sein, wenn der Drucker die Sortierung unterstützt; andernfalls sollte der Rückgabewert null sein.
DC_COLORDEVICE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte 1 sein, wenn der Drucker den Farbdruck unterstützt; andernfalls sollte der Rückgabewert null sein.
DC_COPIES Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte die maximale Anzahl von Kopien sein, die der Drucker unterstützen kann.
DC_DATATYPE_PRODUCED Wird nicht für NT-basierte Betriebssysteme verwendet.
DC_DRIVER Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte der dmDriverVersion Member der internen [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur des Treibers sein.
DC_DUPLEX Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte 1 sein, wenn der Drucker den Duplexdruck unterstützt; andernfalls sollte der Rückgabewert null sein.
DC_EMF_COMPLIANT Wird nicht für NT-basierte Betriebssysteme verwendet.
DC_ENUMRESOLUTIONS Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem LONG-Array füllen soll. Für jede vom Drucker unterstützte Auflösung sollte die Funktion zwei lange Wörter (eine für die x Dimension und eine für die y Dimension) der Auflösung in Punkt pro Zoll zurückgeben. Der Rückgabewert der Funktion sollte die Anzahl der unterstützten Auflösungen sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der unterstützten Auflösungen zurückgeben.
DC_EXTRA Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte die dmDriverExtra Member der internen [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur des Treibers sein.
DC_FIELDS Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte der dmFields Member der internen [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur des Treibers sein. Das dmFields Member gibt an, welche Elemente im geräteunabhängigen Teil der DEVMODEW-Struktur vom Druckertreiber unterstützt werden.
DC_FILEDEPENDENCIES Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 64 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine Zeichenfolge mit breitem Zeichen enthalten, die NULL-beendete Zeichenfolge enthält, die den Namen einer Datei angibt, die mit dem Treiber installiert werden muss. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_MANUFACTURER Wird nicht für NT-basierte Betriebssysteme verwendet.
DC_MAXEXTENT Der pOutput Parameter wird nicht verwendet. Die Funktion sollte eine POINTS-Struktur zurückgeben (in der Microsoft Windows SDK-Dokumentation beschrieben). Die Struktur sollte die maximal zulässigen Werte für die dmPaperWidth- (x Dimension) und dmPaperLength (y Dimension) Member der DEVMODEW-Struktur des Druckers enthalten.
DC_MEDIAREADY Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 64 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine Zeichenfolge mit breitem Zeichen enthalten, die NULL-beendete Zeichenfolge enthält, die den Namen eines Papierformulars angibt, das zur Verwendung verfügbar ist. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_MEDIATYPENAMES Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 64 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine Zeichenfolge mit Breite und NULL-Zeichenfolge enthalten, die den Namen eines unterstützten Medientyps angibt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion einfach die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_MEDIATYPES Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem DWORD-Array füllen soll. Jedes Arrayelement sollte eine DMMEDIA-präfixierte Konstante enthalten (siehe [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur) oder angepasster Wert, der einen unterstützten Medientyp darstellt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion einfach die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_MINEXTENT Der pOutput Parameter wird nicht verwendet. Die Funktion sollte eine POINTS-Struktur zurückgeben (in der Windows SDK-Dokumentation beschrieben). Die Struktur sollte die minimal zulässigen Werte für die dmPaperWidth (x Dimension) und dmPaperLength (y Dimension) Member der DEVMODEW-Struktur des Druckers enthalten.
DC_MODEL Wird nicht für NT-basierte Betriebssysteme verwendet.
DC_NUP Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem DWORD-Array füllen soll. Jedes Arrayelement sollte eine ganze Zahl enthalten, die eine N-Up-Option darstellt (d. r. jede ganze Zahl sollte eine unterstützte Anzahl von Dokumentseiten pro physischer Seite darstellen). Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_ORIENTATION Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte die Anzahl der Drehungsgrade sein, die erforderlich sind, um eine Querformatausrichtung aus hochformat zu erzeugen. Ein Wert von Null gibt an, dass die Querformatausrichtung nicht unterstützt wird.
DC_PAPERNAMES Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 64 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine Zeichenfolge mit breitem Zeichen enthalten, die NULL-beendete Zeichenfolge enthält, die den Namen eines Papierformulars angibt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_PAPERS Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem WORD-Array füllen soll. Jedes Arrayelement sollte eine DMPAPER-Präfixkonstante (oder einen angepassten Wert) enthalten, die ein unterstütztes Papierformular darstellt. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_PAPERSIZE Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem POINT-Array füllen soll. Jedes Arrayelement sollte die x und y Abmessungen des Papierformats eines Formulars in 0,1 mm Einheiten im Hochformat enthalten. Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_PERSONALITY Der pOutput Parameter verweist auf einen Puffer, den die Funktion mit einem Array von Zeichenfolgenpuffern füllen soll, die jeweils 32 Zeichen lang sind. Jeder Zeichenfolgenpuffer im Array sollte eine breitzeichenige, NULL-gekündigte Zeichenfolge enthalten, die die vom Drucker unterstützte Druckerbeschreibungssprache angibt (z. B. L"HP-GL/2"). Der Rückgabewert der Funktion sollte die Anzahl der Elemente im zurückgegebenen Array sein. Wenn pOutput-NULL-ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.
DC_PRINTERMEM Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte eine ganze Zahl sein, die den verfügbaren Druckerspeicher in Kilobyte darstellt.
DC_PRINTRATE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte eine ganze Zahl sein, die die Druckrate in den für DC_PRINTRATEUNIT angegebenen Einheiten darstellt.
DC_PRINTRATEPPM Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte eine ganze Zahl sein, die die Druckrate in Seiten pro Minute darstellt.
DC_PRINTRATEUNIT Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte die Einheiten identifizieren, die zum Angeben des für DC_PRINTRATE zurückgegebenen Werts verwendet werden. Eine der folgenden Konstanten muss angegeben werden: PRINTRATEUNIT_PPM - Seiten/Min. PRINTRATEUNIT_CPS - Zeichen./s. PRINTRATEUNIT_LPM - Linien/Min. PRINTRATEUNIT_IPM - Zoll/Min.
DC_SIZE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte der dmSize Member der internen [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur des Treibers sein.
DC_STAPLE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte TRUE sein, wenn der Drucker Heftung unterstützt, und FALSE-, wenn der Drucker die Heftung nicht unterstützt.
DC_TRUETYPE Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion kann null, ein oder mehrere der folgenden Flags sein: DCTT_BITMAP: Das Gerät kann TrueType-Schriftarten als Grafiken drucken. DCTT_DOWNLOAD: Das Gerät kann heruntergeladene TrueType-Schriftarten akzeptieren. DCTT_DOWNLOAD_OUTLINE: (Nur Windows 95/98/Me) Das Gerät kann Gliederungs-TrueType-Schriftarten herunterladen. DCTT_SUBDEV: Das Gerät kann Geräteschriftarten durch TrueType-Schriftarten ersetzen.
DC_VERSION Der pOutput Parameter wird nicht verwendet. Der Rückgabewert der Funktion sollte der dmSpecVersion Member der internen [DEVMODEW](/windows/win32/api/wingdi/ns-wingdi-devmodew)-Struktur des Treibers sein.

[out] pOutput

Ein vom Aufrufer bereitgestellter Zeiger auf einen Puffer zum Empfangen von Funktionsinformationen. Die Verwendung des Puffers hängt vom empfangenen Wert für den parameter "Capability" ab.

[in, optional] pDevmode

Ein vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW--Struktur, die die aktuellen Druckauftragsmerkmale beschreibt. Wenn dieser Parameter NULL-ist, ruft DrvDeviceCapabilities die aktuellen Standardinitialisierungswerte für den angegebenen Druckertreiber ab, z. B. die Standardmäßige DEVMODEW-Struktur des Benutzers der Druckwarteschlange.

Rückgabewert

Der Rückgabewert der Funktion hängt vom empfangenen Wert für den Parameter "Capability" ab. Wenn der empfangene wert Capability eine Funktion darstellt, die der Treiber nicht unterstützt oder wenn ein Fehler auftritt, sollte die Funktion GDI_ERROR zurückgeben.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- winddiui.h (include Winddiui.h)