struttura DRIVER_UPGRADE_INFO_2 (winddiui.h)

La struttura DRIVER_UPGRADE_INFO_2 viene usata come input per la funzione DrvUpgradePrinter di una DLL dell'interfaccia della stampante.

Sintassi

typedef struct _DRIVER_UPGRADE_INFO_2 {
  LPTSTR pPrinterName;
  LPTSTR pOldDriverDirectory;
  DWORD  cVersion;
  LPTSTR pName;
  LPTSTR pEnvironment;
  LPTSTR pDriverPath;
  LPTSTR pDataFile;
  LPTSTR pConfigFile;
  LPTSTR pHelpFile;
  LPTSTR pDependentFiles;
  LPTSTR pMonitorName;
  LPTSTR pDefaultDataType;
  LPTSTR pszzPreviousNames;
} DRIVER_UPGRADE_INFO_2, *PDRIVER_UPGRADE_INFO_2;

Members

pPrinterName

Puntatore a una stringa con terminazione NULL che specifica il nome della stampante. Per altre informazioni, vedere la sezione Osservazioni.

pOldDriverDirectory

Puntatore a una stringa con terminazione NULL che specifica la directory locale in cui è possibile trovare i file del driver stampante precedenti.

cVersion

Specifica la versione del sistema operativo per cui è stato scritto il driver.

pName

Puntatore a una stringa con terminazione NULL che specifica il nome del driver, ad esempio "QMS 810"). Per altre informazioni, vedere la sezione Osservazioni.

pEnvironment

Puntatore a una stringa con terminazione NULL che specifica l'ambiente per cui è stato scritto il driver, ad esempio "Windows NT x86" o "Windows Itanium").

pDriverPath

Puntatore a una stringa con terminazione NULL che specifica un nome file o un percorso completo e un nome file per il file contenente il driver di dispositivo, ad esempio "pscript.dll").

pDataFile

Puntatore a una stringa con terminazione NULL che specifica un nome file o un percorso completo e un nome file per il file contenente i dati del driver, ad esempio "qms810.ppd").

pConfigFile

Puntatore a una stringa con terminazione NULL che specifica un nome file o un percorso completo e un nome file per la libreria di collegamento dinamico della configurazione del driver del dispositivo, ad esempio "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.

pDependentFiles

Puntatore a una stringa con terminazione NULL che specifica i file a seconda del driver. Ogni nome di file nella stringa viene terminato anche con un carattere Null,ad esempio "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").

pMonitorName

Puntatore a una stringa con terminazione NULL che specifica un monitoraggio del linguaggio ,ad esempio "monitoraggio PJL"). Questo membro può essere NULL e deve essere specificato come non NULL 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 i nomi di driver della stampante precedenti compatibili con questo driver, ad esempio "OldName1\0OldName2\0\0").

Commenti

Quando DrvUpgradePrinter viene chiamato con il parametro pDriverUpgradeInfo che punta a una struttura DRIVER_UPGRADE_INFO_2, il membro pPrinterName punta a una stringa contenente il nome della stampante da aggiornare. Il membro pName punta a una stringa contenente il nome del driver della stampante da aggiornare, che non è necessariamente il driver per la stampante il cui nome è indicato dal membro pPrinterName .

Per vedere come questo può verificarsi, si supponga che un computer sia connesso a due stampanti, uno il cui driver è denominato "Acme Plotter" e l'altro il cui driver è denominato "Acme RasterMaster". Si supponga anche che entrambi i driver condividono un file di driver comune, plotui.dll. Quando il driver "Acme Plotter" viene aggiornato da una chiamata alla funzione AddPrinterDriverEx (descritta nella documentazione di Microsoft Windows SDK), DrvUpgradePrinter viene chiamato per entrambe le stampanti, perché entrambi i driver usano i file interessati dall'aggiornamento. In entrambe le chiamate il membro pName punta a "Acme Plotter", il nome del driver della stampante usato nella chiamata a AddPrinterDriverEx. La stringa a cui punta il membro pPrinterName è diversa in entrambe le chiamate a DrvUpgradePrinter, tuttavia. In ogni chiamata pPrinterName punta al nome della stampante da aggiornare.

Requisiti

Vedi anche

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter