Funzione EngGetPrinterDriver (winddi.h)

Articolo
08/27/2023

La funzione EngGetPrinterDriver recupera i dati del driver per la stampante specificata.

Sintassi

ENGAPI BOOL EngGetPrinterDriver(
  [in]            HANDLE hPrinter,
  [in, optional]  LPWSTR pEnvironment,
  [in]            DWORD  dwLevel,
  [out, optional] BYTE   *lpbDrvInfo,
  [in]            DWORD  cbBuf,
  [out]           DWORD  *pcbNeeded
);

Parametri

[in] hPrinter

Gestire la stampante per cui devono essere recuperati i dati del driver.

[in, optional] pEnvironment

Puntatore a una stringa con terminazione null che specifica l'ambiente. Ad esempio, "Windows NT x86" specifica un sistema operativo basato su NT in esecuzione in un processore Intel. Se pEnvironment è NULL, viene usato l'ambiente corrente del driver chiamante e del computer client.

[in] dwLevel

Specifica la versione della struttura a cui punta lpbDrvInfo . Questo parametro deve essere uno dei valori seguenti:

Valore	Significato
1	GDI scrive una struttura DRIVER_INFO_1 nel buffer in cui punta lpbDrvInfo .
2	GDI scrive una struttura DRIVER_INFO_2 nel buffer in cui punta lpbDrvInfo .
3	GDI scrive una struttura DRIVER_INFO_3 nel buffer in cui punta lpbDrvInfo .

[out, optional] lpbDrvInfo

Puntatore a un buffer in cui GDI inserisce la struttura DRIVER_INFO_X richiesta.

[in] cbBuf

Specifica le dimensioni, in byte, del buffer a cui punta lpbDrvInfo .

[out] pcbNeeded

Puntatore a una posizione di memoria in cui GDI inserisce il numero di byte copiati nel buffer in cui lpbDrvInfo punta al successo o il numero di byte necessari se cbBuf è troppo piccolo.

Valore restituito

EngGetPrinterDriver restituisce TRUE al successo; in caso contrario, segnala un errore e restituisce FALSE.

Commenti

Una DLL del driver della stampante può usare più file di dati per supportare modelli di stampante diversi. Il driver della stampante chiama EngGetPrinterDriver per determinare quale file di dati usare. Ad esempio, il renderer Unidrv chiama questa funzione per determinare il nome di un file GPD e il driver postscript chiama questa funzione per determinare il nome di un file PPD . Le strutture DRIVER_INFO_2 e DRIVER_INFO_3 contengono un percorso completo e un nome file che specifica il percorso del file di dati. Il driver della stampante può quindi usare il percorso restituito e il nome del file per caricare il file di dati chiamando EngLoadModule con il percorso e il nome del file come singolo argomento.

Le strutture DRIVER_INFO_X sono descritte nella documentazione di Microsoft Windows SDK.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

EngLoadModule

Condividi tramite