Compartilhar via


estrutura DRIVER_INFO_8A (winspool.h)

A estrutura DRIVER_INFO_8 contém informações de driver de impressora.

Sintaxe

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;

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 de 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 de 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 quaisquer 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 para o driver de 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 de 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 de 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 de 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 de 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 este 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 ao uso 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. 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)