DRIVER_INFO_8A-Struktur (winspool.h)
Die DRIVER_INFO_8-Struktur enthält Druckertreiberinformationen.
Syntax
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;
Member
cVersion
Dieses Element gibt die Betriebssystemversion an, für die der Treiber geschrieben wurde. Derzeit kann es wie folgt aussehen.
| Wert | Bedeutung |
|---|---|
| 3 | Treiber für Microsoft Windows 2000, XP oder Windows Vista. |
pName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Treibers angibt (z. B. QMS 810).
pEnvironment
Ein Zeiger auf eine NULL-Zeichenfolge, die die Umgebung angibt, für die der Treiber geschrieben wurde (z. B. Microsoft Windows 7, 8 oder Windows Server 2012).
pDriverPath
Ein Zeiger auf eine NULL-Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die den Gerätetreiber enthält (z. B. C:\DRIVERS\Pscript.dll).
pDataFile
Ein Zeiger auf eine NULL-Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die Treiberdaten enthält (z. B. C:\DRIVERS\Qms810.ppd).
pConfigFile
Ein Zeiger auf eine NULL-Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Konfigurationsbibliothek für dynamische Verknüpfungen des Gerätetreibers angibt (z. B. C:\DRIVERS\Pscrptui.dll).
pHelpFile
Ein Zeiger auf eine null-beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Hilfedatei des Gerätetreibers angibt (z. B. C:\DRIVERS\Pscrptui.hlp).
pDependentFiles
Zeiger auf eine Multi-SZ-Zeichenfolge, die die Namen der Dateien enthält, von denen der Treiber abhängt. Die Dateinamen werden als zusammenhängende Reihe von Zeichenfolgen mit Nullen gespeichert, gefolgt von einer leeren Zeichenfolge. Beispiel: Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, wobei \0 das beendende NULL-Zeichen darstellt.
pMonitorName
Ein Zeiger auf eine NULL-Zeichenfolge, die einen Sprachmonitor angibt (z. B. "PJL-Monitor"). Dieser Member kann NULL sein und sollte nur für Drucker angegeben werden, die bidirektional kommunizieren können.
pDefaultDataType
Ein Zeiger auf eine NULL-Zeichenfolge, die den Standarddatentyp des Druckauftrags angibt (z. B. "EMF").
pszzPreviousNames
Ein Zeiger auf eine null-beendete Zeichenfolge, die alle vorherigen Druckertreibernamen angibt, die mit diesem Treiber kompatibel sind (z. B. OldName1\0OldName2\0\0).
ftDriverDate
Das Datum des Treiberpakets, wie in den Treiberdateien codiert.
dwlDriverVersion
Die Versionsnummer des Treibers. Dies kommt aus der Versionsstruktur des Treibers.
pszMfgName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Herstellers angibt.
pszOEMUrl
Ein Zeiger auf eine null-beendete Zeichenfolge, die die URL für den Hersteller angibt.
pszHardwareID
Ein Zeiger auf eine NULL-Zeichenfolge, die die Hardware-ID für den Druckertreiber angibt.
pszProvider
Ein Zeiger auf eine NULL-Zeichenfolge, die den Anbieter des Druckertreibers angibt (z. B. "Microsoft Windows 8").
pszPrintProcessor
Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Druckprozessors angibt, der dem Druckertreiber zugeordnet ist.
pszVendorSetup
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die die Setup-DLL des Anbieters und den Einstiegspunkt für das Anbietersetup angibt, der dem Druckertreiber zugeordnet ist.
pszzColorProfiles
Ein Zeiger auf eine NULL-Zeichenfolge, die alle Farbprofile angibt, die dem Druckertreiber zugeordnet sind.
pszInfPath
Ein Zeiger auf eine null-beendete Zeichenfolge, die den Pfad der INF-Datei innerhalb des Treiberspeichers angibt, aus dem der Druckertreiber installiert wurde. Muss NULL sein, wenn Sie die Funktionen AddPrinterDriver oder AddPrinterDriverEx mit DRIVER_INFO_8 verwenden.
dwPrinterDriverAttributes
Dieses Element gibt druckertreiberbezogene Eigenschaften an. Muss null sein, wenn Sie die Funktionen AddPrinterDriver oder AddPrinterDriverEx mit DRIVER_INFO_8 verwenden. Die folgende Tabelle zeigt die Flags, die für den dwPrinterDriverAttributes-Parameter definiert wurden.
| Flagname/-wert | Bedeutung | Mindestbetriebssystem |
|---|---|---|
| PRINTER_DRIVER_PACKAGE_AWARE 0x00000001 |
Der Druckertreiber ist Teil eines Treiberpakets. | Windows Vista |
| PRINTER_DRIVER_XPS 0x00000002 |
Der Druckertreiber unterstützt das Microsoft XPS-Format, das in der XML-Papierspezifikation: Übersicht und auch in Abschnitt <27> "Produktverhalten" beschrieben wird. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SANDBOX_ENABLED 0x00000004 |
Der Druckertreiber ist mit der Druckertreiberisolation kompatibel. Weitere Informationen finden Sie unter Produktverhalten, Abschnitt <28>. | Windows 7 Windows Server 2008 R2 |
| PRINTER_DRIVER_CLASS 0x00000008 |
Der Druckertreiber ist ein Klassendruckertreiber. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_DERIVED 0x00000010 |
Der Druckertreiber ist ein abgeleiteter Druckertreiber. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_NOT_SHAREABLE 0x00000020 |
Drucker, die diesen Druckertreiber verwenden, können nicht freigegeben werden. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FAX 0x00000040 |
Der Druckertreiber ist für die Verwendung mit Faxdruckern vorgesehen. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FILE 0x00000080 |
Der Druckertreiber ist für die Verwendung mit Dateidruckern vorgesehen. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_VIRTUAL 0x00000100 |
Der Druckertreiber ist für die Verwendung mit virtuellen Druckern vorgesehen. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_SERVICE 0x00000200 |
Der Druckertreiber ist für die Verwendung mit Dienstdruckern vorgesehen. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SOFT_RESET_REQUIRED 0x00000400 |
Drucker, die diesen Druckertreiber verwenden, sollten die unter Definition der USB-Geräteklassen beschriebenen Richtlinien befolgen. Weitere Informationen finden Sie unter Produktverhalten, Abschnitt <36> | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
Der Druckertreiber ist für die Verwendung mit 3D-Druckern vorgesehen. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
Ein Zeiger auf eine NULL-endende Zeichenfolge, die alle Grundlegenden Druckertreiberabhängigkeiten für das Treiberpaket enthält, die von pszInfPath definiert werden. Muss NULL sein, wenn Sie die Funktionen AddPrinterDriver oder AddPrinterDriverEx mit DRIVER_INFO_8 verwenden.
ftMinInboxDriverVerDate
Das früheste zulässige Datum aller Treiber, die mit Windows ausgeliefert wurden und von denen dieser Treiber abhängt.
dwlMinInboxDriverVerVersion
Die früheste zulässige Version aller Treiber, die mit Windows ausgeliefert wurden und von denen dieser Treiber abhängt.
Hinweise
Die Zeichenfolgen für diese Member sind in der INF-Datei enthalten, die zum Hinzufügen des Treibers verwendet wird.
Wenn Sie AddPrinterDriver oder AddPrinterDriverEx mit Level nicht gleich 6 oder 8 aufrufen, Und dann rufen Sie GetPrinterDriver oder EnumPrinterDrivers mit Level gleich 6 oder 8 auf. Die DRIVER_INFO_8-Struktur wird zurückgegeben, wobei pszMfgName, pszOEMUrl, pszHardwareID und pszProvider auf NULL festgelegt sind, dwlDriverVersion auf null und ftDriverDate auf (0,0) festgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | winspool.h (winspool.h einschließen) |