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

Dieser Member gibt die Betriebssystemversion an, für die der Treiber geschrieben wurde. Derzeit kann es wie folgt sein.

Wert	Bedeutung
3	Treiber für Microsoft Windows 2000, XP oder Windows Vista.

pName

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Treibers angibt (z. B. QMS 810).

pEnvironment

Ein Zeiger auf eine auf NULL beendete 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 auf NULL beendete 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 auf NULL terminierte 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 auf NULL beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Dynamic Link-Konfigurationsbibliothek des Gerätetreibers angibt (z. B. C:\DRIVERS\Pscrptui.dll).

pHelpFile

Ein Zeiger auf eine auf 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 Folge von Zeichenfolgen gespeichert, die auf Null beendet werden, 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 auf NULL beendete Zeichenfolge, die einen Sprachmonitor angibt (z. B. "PJL-Monitor"). Dieser Member kann NULL sein und sollte nur für Drucker angegeben werden, die bidirektionale Kommunikation verwenden können.

pDefaultDataType

Ein Zeiger auf eine auf NULL terminierte Zeichenfolge, die den Standarddatentyp des Druckauftrags angibt (z. B. "EMF").

pszzPreviousNames

Ein Zeiger auf eine auf 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 stammt aus der Versionsstruktur des Treibers.

pszMfgName

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Herstellers angibt.

pszOEMUrl

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die die URL für den Hersteller angibt.

pszHardwareID

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die die Hardware-ID für den Druckertreiber angibt.

pszProvider

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Anbieter des Druckertreibers angibt (z. B. "Microsoft Windows 8").

pszPrintProcessor

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Druckprozessors angibt, der dem Druckertreiber zugeordnet ist.

pszVendorSetup

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die die Setup-DLL des Herstellers und den Einstiegspunkt für die Herstellereinrichtung angibt, die dem Druckertreiber zugeordnet ist.

pszzColorProfiles

Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die alle Farbprofile angibt, die dem Druckertreiber zugeordnet sind.

pszInfPath

Ein Zeiger auf eine auf 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.

dwPrinterDriverAttributes

Dieser Member gibt druckertreiberbezogene Eigenschaften an. Muss 0 (null) sein, wenn die Funktionen AddPrinterDriver oder AddPrinterDriverEx mit DRIVER_INFO_8. 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 im Abschnitt XML Paper Specification: Übersicht und im Abschnitt Produktverhalten beschrieben wird <27>.	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 in DEFINITION der USB-Geräteklasse beschriebenen Richtlinien befolgen. Weitere Informationen finden Sie im Abschnitt "Produktverhalten". <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 auf NULL terminierte Zeichenfolge, die alle Hauptabhängigkeiten des Druckertreibers 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.

ftMinInboxDriverVerDate

Das früheste zulässige Datum aller Treiber, die mit Windows geliefert wurden und von denen dieser Treiber abhängt.

dwlMinInboxDriverVerVersion

Die früheste zulässige Version aller Treiber, die im Lieferumfang Windows 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 der Ebene 6 oder 8 aufrufen, Und dann rufen Sie GetPrinterDriver oder EnumPrinterDrivers auf, deren Ebene gleich 6 oder 8 ist. Die DRIVER_INFO_8-Struktur wird zurückgegeben, wenn pszMfgName, pszOEMUrl, pszHardwareID und pszProvider auf NULL, dwlDriverVersion auf 0 und ftDriverDate auf (0,0) festgelegt sind.

Anforderungen

Kopfzeile	winspool.h (winspool.h enthalten)