estrutura DRIVER_INFO_8W (winspool.h)
A estrutura DRIVER_INFO_8 contém informações do driver da impressora.
Sintaxe
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;
Membros
cVersion
Esse membro especifica a versão do sistema operacional para a qual o driver foi gravado. Atualmente, pode ser o seguinte.
| Valor | Significado |
|---|---|
| 3 | Driver para Microsoft Windows 2000, XP ou Windows Vista. |
pName
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do driver (por exemplo, QMS 810).
pEnvironment
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o ambiente para o qual o driver foi gravado (por exemplo, Microsoft Windows 7, 8 ou Windows Server 2012).
pDriverPath
Um 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 que contém o driver do dispositivo (por exemplo, C:\DRIVERS\Pscript.dll).
pDataFile
Um 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 que contém dados do driver (por exemplo, C:\DRIVERS\Qms810.ppd).
pConfigFile
Um 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 a biblioteca de vínculo dinâmico de configuração do driver de dispositivo (por exemplo, C:\DRIVERS\Pscrptui.dll).
pHelpFile
Um 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 (por exemplo, C:\DRIVERS\Pscrptui.hlp).
pDependentFiles
Ponteiro para uma cadeia de caracteres Multi-SZ que contém os nomes dos arquivos dos quais o driver depende. Os nomes de arquivo são armazenados como uma série contígua de cadeias de caracteres terminadas em zero seguidas por uma cadeia de caracteres vazia. Por exemplo, Pscript.dll\0QMS810.ppd\0Pscriptui.dll\0Pscriptui.hlp\0Pstest.txt\0\0, em que \0 representa o caractere nulo de terminação.
pMonitorName
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica um monitor de idioma (por exemplo, "Monitor PJL"). Esse membro pode ser NULL e deve ser especificado apenas para impressoras capazes de comunicação bidirecional.
pDefaultDataType
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o tipo de dados padrão do trabalho de impressão (por exemplo, "EMF").
pszzPreviousNames
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica todos os nomes de driver de impressora anteriores compatíveis com esse driver (por exemplo, OldName1\0OldName2\0\0).
ftDriverDate
A data do pacote de driver, conforme codificado nos arquivos de driver.
dwlDriverVersion
O número de versão do driver. Isso sai da estrutura de versão do driver.
pszMfgName
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do fabricante.
pszOEMUrl
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL do fabricante.
pszHardwareID
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a ID de hardware do driver da impressora.
pszProvider
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o provedor do driver de impressora (por exemplo, "Microsoft Windows 8").
pszPrintProcessor
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do processador de impressão associado ao driver da impressora.
pszVendorSetup
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a DLL de configuração do fornecedor e o ponto de entrada para a configuração do fornecedor associada ao driver da impressora.
pszzColorProfiles
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica todos os perfis de cor associados ao driver da impressora.
pszInfPath
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho do arquivo INF dentro do repositório de driver do qual o driver da impressora foi instalado. Deve ser NULL se estiver usando as funções AddPrinterDriver ou AddPrinterDriverEx com DRIVER_INFO_8.
dwPrinterDriverAttributes
Esse membro especifica as propriedades relacionadas ao driver da impressora. Deve ser zero se estiver usando as funções AddPrinterDriver ou AddPrinterDriverEx com DRIVER_INFO_8. A tabela a seguir mostra os sinalizadores que foram definidos para o parâmetro dwPrinterDriverAttributes .
| Nome/valor do sinalizador | Significado | Sistema operacional mínimo |
|---|---|---|
| PRINTER_DRIVER_PACKAGE_AWARE 0x00000001 |
O driver da impressora faz parte de um pacote de driver. | Windows Vista |
| PRINTER_DRIVER_XPS 0x00000002 |
O driver da impressora dá suporte ao formato XPS da Microsoft descrito na Especificação de Papel XML: Visão geral e também no Comportamento do Produto, seção <27>. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SANDBOX_ENABLED 0x00000004 |
O driver da impressora é compatível com o isolamento do driver da impressora. Para obter mais informações, consulte Comportamento do produto, seção <28>. | Windows 7 Windows Server 2008 R2 |
| PRINTER_DRIVER_CLASS 0x00000008 |
O driver da impressora é um driver de impressora de classe. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_DERIVED 0x00000010 |
O driver da impressora é um driver de impressora derivado. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_NOT_SHAREABLE 0x00000020 |
Impressoras que usam esse driver de impressora não podem ser compartilhadas. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FAX 0x00000040 |
O driver da impressora destina-se ao uso com impressoras de fax. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_FILE 0x00000080 |
O driver da impressora destina-se a ser usado com impressoras de arquivo. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_VIRTUAL 0x00000100 |
O driver da impressora destina-se ao uso com impressoras virtuais. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_SERVICE 0x00000200 |
O driver da impressora destina-se ao uso com impressoras de serviço. | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_SOFT_RESET_REQUIRED 0x00000400 |
As impressoras que usam esse driver de impressora devem seguir as diretrizes descritas em [Definição de Classe de Dispositivo USB](Definição de Classe de Dispositivo USB. Para obter mais informações, consulte Comportamento do produto, seção <36> | Windows 8 Windows Server 2012 |
| PRINTER_DRIVER_CATEGORY_3D 0x00001000 |
O driver da impressora destina-se ao uso com impressoras 3D. | Windows 8 Windows Server 2012 |
pszzCoreDriverDependencies
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém todas as dependências principais do driver de impressora para o pacote de driver definido por pszInfPath. Deve ser NULL se estiver usando as funções AddPrinterDriver ou AddPrinterDriverEx com DRIVER_INFO_8.
ftMinInboxDriverVerDate
A data mais antiga permitida de todos os drivers que foram enviados com o Windows e da qual esse driver depende.
dwlMinInboxDriverVerVersion
A versão mais antiga permitida de todos os drivers que foram enviados com o Windows e da qual esse driver depende.
Comentários
As cadeias de caracteres para esses membros estão contidas no arquivo INF usado para adicionar o driver.
Se você chamar AddPrinterDriver ou AddPrinterDriverEx com Nível não igual a 6 ou 8, e, em seguida, você chama GetPrinterDriver ou EnumPrinterDrivers com Level igual a 6 ou 8, a estrutura DRIVER_INFO_8 é retornada com pszMfgName, pszOEMUrl, pszHardwareID e pszProvider definido como NULL, dwlDriverVersion definido como zero e ftDriverDate definido como (0,0).
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | winspool.h (inclua Winspool.h) |