struttura DRIVER_INFO_8A (winspool.h)

La struttura DRIVER_INFO_8 contiene informazioni sul driver della stampante.

Sintassi

typedef struct _DRIVER_INFO_8A {
  DWORD     cVersion;
  LPSTR     pName;
  LPSTR     pEnvironment;
  LPSTR     pDriverPath;
  LPSTR     pDataFile;
  LPSTR     pConfigFile;
  LPSTR     pHelpFile;
  LPSTR     pDependentFiles;
  LPSTR     pMonitorName;
  LPSTR     pDefaultDataType;
  LPSTR     pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPSTR     pszMfgName;
  LPSTR     pszOEMUrl;
  LPSTR     pszHardwareID;
  LPSTR     pszProvider;
  LPSTR     pszPrintProcessor;
  LPSTR     pszVendorSetup;
  LPSTR     pszzColorProfiles;
  LPSTR     pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPSTR     pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8A, *PDRIVER_INFO_8A, *LPDRIVER_INFO_8A;

Members

cVersion

Questo membro specifica la versione del sistema operativo per la quale è stato scritto il driver. Attualmente può essere il seguente.

Valore Significato
3 Driver per Microsoft Windows 2000, XP o Windows Vista.

pName

Puntatore a una stringa con terminazione Null che specifica il nome del driver, ad esempio QMS 810.

pEnvironment

Puntatore a una stringa con terminazione Null che specifica l'ambiente per cui è stato scritto il driver, ad esempio Microsoft Windows 7, 8 o Windows Server 2012.

pDriverPath

Puntatore a una stringa con terminazione Null che specifica un nome file o un percorso completo e un nome di file per il file che contiene il driver di dispositivo, ad esempio C:\DRIVERS\Pscript.dll.

pDataFile

Puntatore a una stringa con terminazione Null che specifica un nome file o un percorso completo e un nome di file per il file che contiene i dati del driver , ad esempio C:\DRIVERS\Qms810.ppd.

pConfigFile

Puntatore a una stringa con terminazione Null che specifica un nome file o un percorso completo e un nome di file per la libreria di collegamento dinamico della configurazione del driver di dispositivo, ad esempio C:\DRIVERS\Pscrptui.dll.

pHelpFile

Puntatore a una stringa con terminazione Null che specifica un nome file o un percorso completo e un nome file per il file della Guida del driver di dispositivo, ad esempio C:\DRIVERS\Pscrptui.hlp.

pDependentFiles

Puntatore a una stringa Multi-SZ contenente i nomi dei file da cui dipende il driver. I nomi di file vengono archiviati come una serie contigua di stringhe con terminazione zero seguita da una stringa vuota. Ad esempio, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, dove \0 rappresenta il carattere Null di terminazione.

pMonitorName

Puntatore a una stringa con terminazione Null che specifica un monitoraggio del linguaggio (ad esempio, "monitor PJL"). Questo membro può essere NULL e deve essere specificato solo per le stampanti in grado di comunicare bidirezionale.

pDefaultDataType

Puntatore a una stringa con terminazione Null che specifica il tipo di dati predefinito del processo di stampa, ad esempio "EMF".

pszzPreviousNames

Puntatore a una stringa con terminazione Null che specifica tutti i nomi di driver della stampante precedenti compatibili con questo driver, ad esempio OldName1\0OldName2\0\0.

ftDriverDate

Data del pacchetto driver, come codificato nei file del driver.

dwlDriverVersion

Numero di versione del driver. Questo esce dalla struttura della versione del driver.

pszMfgName

Puntatore a una stringa con terminazione Null che specifica il nome del produttore.

pszOEMUrl

Puntatore a una stringa con terminazione Null che specifica l'URL per il produttore.

pszHardwareID

Puntatore a una stringa con terminazione Null che specifica l'ID hardware per il driver della stampante.

pszProvider

Puntatore a una stringa con terminazione Null che specifica il provider del driver della stampante, ad esempio "Microsoft Windows 8").

pszPrintProcessor

Puntatore a una stringa con terminazione Null che specifica il nome del processore di stampa associato al driver della stampante.

pszVendorSetup

Puntatore a una stringa con terminazione Null che specifica la DLL di installazione del fornitore e il punto di ingresso per la configurazione del fornitore associata al driver della stampante.

pszzColorProfiles

Puntatore a una stringa con terminazione Null che specifica tutti i profili colore associati al driver della stampante.

pszInfPath

Puntatore a una stringa con terminazione Null che specifica il percorso del file INF all'interno dell'archivio driver da cui è stato installato il driver della stampante. Deve essere NULL se si usano le funzioni AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8.

dwPrinterDriverAttributes

Questo membro specifica le proprietà correlate al driver della stampante. Deve essere zero se si usano le funzioni AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8. La tabella seguente illustra i flag definiti per il parametro dwPrinterDriverAttributes .

Nome/valore del flag Significato Sistema operativo minimo
PRINTER_DRIVER_PACKAGE_AWARE

0x00000001
Il driver della stampante fa parte di un pacchetto driver. Windows Vista
PRINTER_DRIVER_XPS

0x00000002
Il driver della stampante supporta il formato Microsoft XPS descritto in XML Paper Specification: Overview e anche in Product Behavior, sezione <27>. Windows 8

Windows Server 2012
PRINTER_DRIVER_SANDBOX_ENABLED

0x00000004
Il driver della stampante è compatibile con l'isolamento del driver della stampante. Per altre informazioni, vedere Comportamento del prodotto, sezione <28>. Windows 7

Windows Server 2008 R2
PRINTER_DRIVER_CLASS

0x00000008
Il driver della stampante è un driver della stampante di classe. Windows 8

Windows Server 2012
PRINTER_DRIVER_DERIVED

0x00000010
Il driver della stampante è un driver della stampante derivato. Windows 8

Windows Server 2012
PRINTER_DRIVER_NOT_SHAREABLE

0x00000020
Le stampanti che usano questo driver della stampante non possono essere condivise. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_FAX

0x00000040
Il driver della stampante è destinato all'uso con stampanti fax. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_FILE

0x00000080
Il driver della stampante è destinato all'uso con le stampanti di file. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_VIRTUAL

0x00000100
Il driver della stampante è destinato all'uso con stampanti virtuali. Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_SERVICE

0x00000200
Il driver della stampante è destinato all'uso con stampanti di servizio. Windows 8

Windows Server 2012
PRINTER_DRIVER_SOFT_RESET_REQUIRED

0x00000400
Le stampanti che usano questo driver della stampante devono seguire le linee guida descritte in Definizione della classe di dispositivo USB. Per altre informazioni, vedere Comportamento del prodotto, sezione <36> Windows 8

Windows Server 2012
PRINTER_DRIVER_CATEGORY_3D

0x00001000
Il driver della stampante è destinato all'uso con stampanti 3D. Windows 8

Windows Server 2012

pszzCoreDriverDependencies

Puntatore a una stringa con terminazione null contenente tutte le dipendenze del driver della stampante principale per il pacchetto driver definito da pszInfPath. Deve essere NULL se si usano le funzioni AddPrinterDriver o AddPrinterDriverEx con DRIVER_INFO_8.

ftMinInboxDriverVerDate

La data più recente consentita di tutti i driver che sono stati forniti con Windows e su cui dipende questo driver.

dwlMinInboxDriverVerVersion

La versione più recente consentita di tutti i driver forniti con Windows e su cui dipende questo driver.

Commenti

Le stringhe per questi membri sono contenute nel file INF usato per aggiungere il driver.

Se si chiama AddPrinterDriver o AddPrinterDriverEx con Level non uguale a 6 o 8, e quindi chiami GetPrinterDriver o EnumPrinterDrivers con Level uguale a 6 o 8, la struttura DRIVER_INFO_8 viene restituita con pszMfgName, pszOEMUrl, pszHardwareID e pszProvider impostata su NULL, dwlDriverVersion impostata su zero e ftDriverDate impostata su (0,0).

Requisiti

Requisito Valore
Intestazione winspool.h (include Winspool.h)