estrutura DRIVER_UPGRADE_INFO_2 (winddiui.h)
A estrutura DRIVER_UPGRADE_INFO_2 é usada como uma entrada para a função DrvUpgradePrinter de uma interface de impressora.
Sintaxe
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;
Membros
pPrinterName
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome da impressora. Para obter mais informações, consulte a seção Comentários.
pOldDriverDirectory
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o diretório local no qual os arquivos antigos do driver de impressora podem ser encontrados.
cVersion
Especifica a versão do sistema operacional para a qual o driver foi gravado.
| Valor | Sistema operacional |
|---|---|
| 0 | Windows 95/98/Me |
| 1 | Windows NT 3.1 a Windows NT 3.51 |
| 2 | Windows NT 4.0 |
| 3 | Windows 2000 e posterior |
pName
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome do driver (por exemplo, "QMS 810"). Para obter mais informações, consulte a seção Comentários.
pEnvironment
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o ambiente para o qual o driver foi gravado (por exemplo, "Windows NT x86" ou "Windows Itanium").
pDriverPath
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo que contém o driver do dispositivo (por exemplo, "pscript.dll").
pDataFile
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo que contém dados do driver (por exemplo, "qms810.ppd").
pConfigFile
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para a biblioteca de vínculo dinâmico de configuração do driver de dispositivo (por exemplo, "pscrptui.dll").
pHelpFile
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica um nome de arquivo ou um caminho completo e um nome de arquivo para o arquivo de ajuda do driver do dispositivo.
pDependentFiles
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica os arquivos dos quais o driver depende. Cada nome de arquivo na cadeia de caracteres também é encerrado com um caractere nulo (por exemplo, "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").
pMonitorName
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica um monitor de idioma (por exemplo, "Monitor PJL"). Esse membro pode ser NULL e deve ser especificado como não NULL somente para impressoras capazes de comunicação bidirecional.
pDefaultDataType
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica o tipo de dados padrão do trabalho de impressão (por exemplo, "EMF").
pszzPreviousNames
Ponteiro para uma cadeia de caracteres terminada em NULL que especifica quaisquer nomes de driver de impressora anteriores compatíveis com esse driver (por exemplo, "OldName1\0OldName2\0\0").
Comentários
Quando DrvUpgradePrinter é chamado com seu parâmetro pDriverUpgradeInfo apontando para uma estrutura DRIVER_UPGRADE_INFO_2, o membro pPrinterName aponta para uma cadeia de caracteres que contém o nome da impressora a ser atualizada. O membro pName aponta para uma cadeia de caracteres que contém o nome do driver da impressora a ser atualizado, que não é necessariamente o driver da impressora cujo nome é apontado pelo membro pPrinterName .
Para ver como isso pode ocorrer, suponha que um computador esteja conectado a duas impressoras, uma cujo driver é chamado de "Plotador acme" e o outro cujo driver é chamado de "Acme RasterMaster". Suponha também que ambos os drivers compartilhem um arquivo de driver comum, plotui.dll. Quando o driver "Plotador acme" é atualizado por uma chamada para a função AddPrinterDriverEx (descrita na documentação do SDK do Microsoft Windows), DrvUpgradePrinter é chamado para ambas as impressoras, pois ambos os drivers usam arquivos afetados pela atualização. Em ambas as chamadas, o membro pName aponta para "Plotador acme", o nome do driver de impressora usado na chamada para AddPrinterDriverEx. No entanto, a cadeia de caracteres apontada pelo membro pPrinterName é diferente em ambas as chamadas para DrvUpgradePrinter. Em cada chamada, pPrinterName aponta para o nome da impressora que está sendo atualizada.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | winddiui.h (inclua Winddiui.h) |