estrutura DRIVER_INFO_8

  • Artigo

Contém informações do driver da impressora.

Sintaxe

typedef struct _DRIVER_INFO_8 {
  DWORD     cVersion;
  LPTSTR    pName;
  LPTSTR    pEnvironment;
  LPTSTR    pDriverPath;
  LPTSTR    pDataFile;
  LPTSTR    pConfigFile;
  LPTSTR    pHelpFile;
  LPTSTR    pDependentFiles;
  LPTSTR    pMonitorName;
  LPTSTR    pDefaultDataType;
  LPTSTR    pszzPreviousNames;
  FILETIME  ftDriverDate;
  DWORDLONG dwlDriverVersion;
  LPTSTR    pszMfgName;
  LPTSTR    pszOEMUrl;
  LPTSTR    pszHardwareID;
  LPTSTR    pszProvider;
  LPTSTR    pszPrintProcessor;
  LPTSTR    pszVendorSetup;
  LPTSTR    pszzColorProfiles;
  LPTSTR    pszInfPath;
  DWORD     dwPrinterDriverAttributes;
  LPTSTR    pszzCoreDriverDependencies;
  FILETIME  ftMinInboxDriverVerDate;
  DWORDLONG dwlMinInboxDriverVerVersion;
} DRIVER_INFO_8, *PDRIVER_INFO_8, *LPDRIVER_INFO_8;

Membros

cVersion

A versão do sistema operacional para a qual o driver foi gravado. O valor com suporte é 3.

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, Windows x86, Windows IA64 e Windows x64.

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

Um ponteiro para um buffer MultiSZ que contém uma sequência de cadeias de caracteres terminadas em nulo. Cada cadeia de caracteres terminada em nulo no buffer contém o nome de um arquivo do qual o driver depende. A sequência de cadeias de caracteres é encerrada por uma cadeia de caracteres vazia de comprimento zero. Se pDependentFiles não for NULL e não contiver nomes de arquivo, ele apontará para um buffer que contém duas cadeias de caracteres vazias.

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 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 vem 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 2000").

pszPrintProcessor

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o processador de impressão (por exemplo, "WinPrint").

pszVendorSetup

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica a DLL de configuração do driver do fornecedor e o ponto de entrada.

pszzColorProfiles

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica os perfis de cor associados ao driver.

pszInfPath

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho para o arquivo .inf do driver no repositório de driver. (Consulte Comentários.) Isso deverá ser NULL se o DRIVER_INFO_8 estiver sendo passado para AddPrinterDriver ou AddPrinterDriverEx.

dwPrinterDriverAttributes

Sinalizadores de atributo para drivers de impressora. Isso deve ser 0 se o DRIVER_INFO_8 estiver sendo passado para AddPrinterDriver ou AddPrinterDriverEx. Caso contrário, pode ser qualquer combinação dos seguintes sinalizadores:

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 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 na Definição de Classe de Dispositivo USB. Para obter mais informações, consulte Comportamento do produto, seção <36> Windows 8
Windows Server 2012

pszzCoreDriverDependencies

Um ponteiro para uma cadeia de caracteres múltipla terminada em nulo que especifica todos os drivers de impressora principais dos quais o driver depende. Isso deverá ser NULL se o DRIVER_INFO_8 estiver sendo passado para AddPrinterDriver ou AddPrinterDriverEx.

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Winspool.h (inclua Windows.h)
Nomes Unicode e ANSI
 _DRIVER_INFO_8W (Unicode) e _DRIVER_INFO_8A (ANSI)

Confira também

Impressão

Estruturas de API do Spooler de Impressão

AddPrinterDriver

AddPrinterDriverEx