Funzione DrvSplDeviceCaps (winddiui.h)

Articolo
03/13/2023

La funzione DrvSplDeviceCaps di una DLL dell'interfaccia della stampante 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 per. 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.

Flag	Definizione
DC_MEDIAREADY	Il parametro pOutput 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 di carta 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 parametro pOutput 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.

Flag

Definizione

DC_MEDIAREADY

Il parametro pOutput 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 di carta 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 parametro pOutput 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 struttura DEVMODEW 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.

Commenti

Per le descrizioni dei flag DC_XXX , 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winddiui.h (include Winddiui.h)

Vedi anche

DrvDeviceCapabilities