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) |