DrvSplDeviceCaps-Funktion (winddiui.h)

Artikel
03/01/2024

Die DrvSplDeviceCaps-Funktion einer Druckerschnittstellen-DLL 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 Griff zum Drucker.

[in] pszDeviceName

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

Capability

Vom Aufrufer bereitgestelltes Bitflag, das die Funktion angibt, nach der eine Abfrage ausgeführt werden soll. (Die Flags sind 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.

Flag	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 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 pOutputNULL 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 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 pOutputNULL ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.

Flag

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 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 pOutputNULL 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 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 pOutputNULL ist, sollte die Funktion nur die Anzahl der erforderlichen Arrayelemente zurückgeben.

[out, optional] pOutput

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der von der Funktion bereitgestellte Informationen empfängt. Die Verwendung des Puffers hängt vom Wert des Capability-Parameters ab. Der Aufrufer ist für die Zuweisung und Freigabe dieses Puffers verantwortlich.

cchBufSize

Vom Aufrufer angegebene 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 Eigenschaften des Druckauftrags beschreibt. Bei NULL sollte die Funktion die interne DEVMODEW-Standardstruktur des Treibers verwenden.

Rückgabewert

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

Hinweise

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 verwendet, um den Treiberfunktionszeiger abzurufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	winddiui.h (include Winddiui.h)

Weitere Informationen

DrvDeviceCapabilities

Freigeben über