Função EngGetPrinterDriver (winddi.h)

A função EngGetPrinterDriver recupera dados de driver para a impressora especificada.

Sintaxe

ENGAPI BOOL EngGetPrinterDriver(
  [in]            HANDLE hPrinter,
  [in, optional]  LPWSTR pEnvironment,
  [in]            DWORD  dwLevel,
  [out, optional] BYTE   *lpbDrvInfo,
  [in]            DWORD  cbBuf,
  [out]           DWORD  *pcbNeeded
);

Parâmetros

[in] hPrinter

Identificador para a impressora para a qual os dados do driver devem ser recuperados.

[in, optional] pEnvironment

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o ambiente. Por exemplo, "Windows NT x86" especifica um sistema operacional baseado em NT em execução em um processador Intel. Se pEnvironment for NULL, o ambiente atual do driver de chamada e do computador cliente será usado.

[in] dwLevel

Especifica a versão da estrutura para a qual lpbDrvInfo aponta. Esse parâmetro deve ser um dos seguintes valores:

[out, optional] lpbDrvInfo

Ponteiro para um buffer no qual a GDI coloca a estrutura DRIVER_INFO_X solicitada.

[in] cbBuf

Especifica o tamanho, em bytes, do buffer para o qual lpbDrvInfo aponta.

[out] pcbNeeded

Ponteiro para um local de memória no qual a GDI coloca o número de bytes copiados no buffer para o qual lpbDrvInfo aponta após o êxito ou o número de bytes necessários se cbBuf for muito pequeno.

Retornar valor

EngGetPrinterDriver retorna TRUE após êxito; caso contrário, ele relatará um erro e retornará FALSE.

Comentários

Uma DLL de driver de impressora pode trabalhar com vários arquivos de dados para dar suporte a diferentes modelos de impressora. O driver da impressora chama EngGetPrinterDriver para determinar qual arquivo de dados usar. Por exemplo, o renderizador Unidrv chama essa função para determinar o nome de um arquivo GPD e o driver postscript chama essa função para determinar o nome de um arquivo PPD . As estruturas DRIVER_INFO_2 e DRIVER_INFO_3 contêm um caminho completo e um nome de arquivo especificando o local do arquivo de dados. Em seguida, o driver de impressora pode usar o caminho e o nome do arquivo retornados para carregar o arquivo de dados chamando EngLoadModule com o caminho e o nome do arquivo como um único argumento.

As estruturas DRIVER_INFO_X são descritas na documentação do SDK do Microsoft Windows.

Requisitos

Confira também

EngLoadModule