Funzione DrvSplDeviceCaps (winddiui.h)

Articolo
02/07/2025

Una DLL dell'interfaccia della stampante DrvSplDeviceCaps funzione esegue una query su una stampante per le relative funzionalità.

Sintassi

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

Parametri

hPrinter

Handle fornito dal chiamante alla stampante.

[in] pszDeviceName

Puntatore fornito dal chiamante a una stringa Unicode contenente il nome della stampante.

Capability

Flag di bit fornito dal chiamante che indica la capacità di eseguire query. I flag sono definiti nel file di intestazione wingdi.h. Questa funzione non è necessaria per supportare tutti i flag DC_XXX, ma deve supportare quelli elencati nella tabella seguente.

Bandiera	Definizione
DC_MEDIAREADY	Il pOutput parametro punta a un buffer che la funzione deve riempire con una matrice di buffer stringa, ogni 64 caratteri di lunghezza. Ogni elemento matrice deve contenere una stringa con terminazione NULL che rappresenta un nome per un modulo cartaceo disponibile per l'uso. Il valore restituito della funzione deve essere il numero di elementi nella matrice restituita. Se pOutput è NULL, la funzione deve restituire solo il numero di elementi della matrice necessari.
DC_PAPERNAMES	Il pOutput parametro punta a un buffer che la funzione deve riempire con una matrice di buffer stringa, ogni 64 caratteri di lunghezza. Ogni elemento matrice deve contenere una stringa con terminazione NULL che rappresenta un nome per un modulo cartaceo. Il valore restituito della funzione deve essere il numero di elementi nella matrice restituita. Se pOutput è NULL, la funzione deve restituire solo il numero di elementi della matrice necessari.

Bandiera

Definizione

DC_MEDIAREADY

Il pOutput parametro punta a un buffer che la funzione deve riempire con una matrice di buffer stringa, ogni 64 caratteri di lunghezza. Ogni elemento matrice deve contenere una stringa con terminazione NULL che rappresenta un nome per un modulo cartaceo disponibile per l'uso. Il valore restituito della funzione deve essere il numero di elementi nella matrice restituita. Se pOutput è NULL, la funzione deve restituire solo il numero di elementi della matrice necessari.

DC_PAPERNAMES

Il pOutput parametro punta a un buffer che la funzione deve riempire con una matrice di buffer stringa, ogni 64 caratteri di lunghezza. Ogni elemento matrice deve contenere una stringa con terminazione NULL che rappresenta un nome per un modulo cartaceo. Il valore restituito della funzione deve essere il numero di elementi nella matrice restituita. Se pOutput è NULL, la funzione deve restituire solo il numero di elementi della matrice necessari.

[out, optional] pOutput

Puntatore fornito dal chiamante a un buffer che riceve informazioni fornite dalla funzione. L'uso del buffer dipende dal valore del parametro capability. Il chiamante è responsabile dell'allocazione e della liberazione di questo buffer.

cchBufSize

Dimensione fornita dal chiamante (in caratteri) del buffer a cui punta il parametro pOutput.

[in, optional] pDevmode

Puntatore fornito dal chiamante a una strutturaDEVMODEW che descrive le caratteristiche correnti del processo di stampa. Se NULL, la funzione deve usare la struttura DEVMODEW predefinita interna del driver.

Valore restituito

Il valore restituito dipende dal parametro capability. Se Capability indica una funzionalità che il driver non supporta o se viene rilevato un errore, la funzione deve restituire GDI_ERROR.

Osservazioni

Per le descrizioni dei flag diXXX DC_, vedere DrvDeviceCapabilities.

Questa funzione deve essere definita nel file con estensione def come DrvSplDeviceCaps @ 254, perché lo spooler usa il numero ordinale 254 per ottenere il puntatore alla funzione del driver.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	winddiui.h (include Winddiui.h)

Vedere anche

DrvDeviceCapabilities

Condividi tramite