Freigeben über


DRIVER_INFO_8W-Struktur (winspool.h)

Die DRIVER_INFO_8-Struktur enthält Druckertreiberinformationen.

Syntax

typedef struct _DRIVER_INFO_8W {
  DWORD     cVersion;
  LPWSTR    pName;
  LPWSTR    pEnvironment;
  LPWSTR    pDriverPath;
  LPWSTR    pDataFile;
  LPWSTR    pConfigFile;
  LPWSTR    pHelpFile;
  LPWSTR    pDependentFiles;
  LPWSTR    pMonitorName;
  LPWSTR    pDefaultDataType;
  LPWSTR    pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPWSTR    pszMfgName;
  LPWSTR    pszOEMUrl;
  LPWSTR    pszHardwareID;
  LPWSTR    pszProvider;
  LPWSTR    pszPrintProcessor;
  LPWSTR    pszVendorSetup;
  LPWSTR    pszzColorProfiles;
  LPWSTR    pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPWSTR    pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8W, *PDRIVER_INFO_8W, *LPDRIVER_INFO_8W;

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 richtlinien befolgen, die unter [USB Device Class Definition](USB Device Class Definition) beschrieben sind. 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-beendete 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 (einschließlich Winspool.h)