DrvSplDeviceCaps-Funktion (winddiui.h)

Artikel
02/07/2025

Die DrvSplDeviceCaps-Funktion einer Druckerschnittstelle fragt einen Drucker nach seinen Funktionen ab.

Syntax

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

Parameter

hPrinter

Vom Anrufer bereitgestellter Handle für den Drucker.

[in] pszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine Unicode-Zeichenfolge, die den Druckernamen enthält.

Capability

Vom Aufrufer bereitgestelltes Bit-Flag, das die Abfragefunktion angibt. (Die Flags werden in der Headerdatei wingdi.h definiert.) Diese Funktion ist nicht erforderlich, um alle DC_XXX- Flags zu unterstützen, aber sie muss die in der folgenden Tabelle aufgeführten Unterstützen.

Flagge	Definition
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. Jedes Arrayelement sollte eine MIT NULL beendete Zeichenfolge enthalten, die einen Namen für ein Papierformular darstellt, 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_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. Jedes Arrayelement sollte eine MIT NULL beendete Zeichenfolge enthalten, die einen Namen für ein 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.

Flagge

Definition

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. Jedes Arrayelement sollte eine MIT NULL beendete Zeichenfolge enthalten, die einen Namen für ein Papierformular darstellt, 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_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. Jedes Arrayelement sollte eine MIT NULL beendete Zeichenfolge enthalten, die einen Namen für ein 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.

[out, optional] pOutput

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der funktionsbezogene Informationen empfängt. Die Verwendung des Puffers hängt vom Wert des parameters Capability ab. Der Aufrufer ist für das Zuweisen und Freigeben dieses Puffers verantwortlich.

cchBufSize

Vom Aufrufer bereitgestellte Größe (in Zeichen) des Puffers, auf den der pOutput-Parameter verweist.

[in, optional] pDevmode

Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW- Struktur, die die aktuellen Druckauftragsmerkmale beschreibt. Wenn NULL-, sollte die Funktion die interne DevMODEW-Standardstruktur des Treibers verwenden.

Rückgabewert

Der Rückgabewert hängt vom parameter Capability ab. Wenn Capability eine Funktion angibt, die der Treiber nicht unterstützt, oder wenn ein Fehler auftritt, sollte die Funktion GDI_ERROR zurückgeben.

Bemerkungen

Beschreibungen der DC_XXX Flags finden Sie unter DrvDeviceCapabilities.

Diese Funktion muss in der DEF-Datei als DrvSplDeviceCaps @ 254 definiert werden, da der Spooler die Ordnungszahl 254 zum Abrufen des Treiberfunktionspunkts verwendet.

Anforderungen

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

Siehe auch

DrvDeviceCapabilities

Freigeben über