Método IPrintOemDriverPS::D rvGetDriverSetting (prcomoem.h)

  • Artigo

O IPrintOemDriverPS::DrvGetDriverSetting método é fornecido pelo driver Pscript5 para que os plug-ins de renderização possam obter o status atual dos recursos da impressora e outras informações internas.

Sintaxe

HRESULT DrvGetDriverSetting(
  PVOID  pdriverobj,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Parâmetros

pdriverobj

Ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

Feature

Valor fornecido pelo chamador que identifica o recurso de impressora para quais configurações de opção serão retornadas. Isso pode ser um ponteiro de cadeia de caracteres ou uma constante, conforme descrito na seção Comentários a seguir.

pOutput

Ponteiro fornecido pelo chamador para um buffer para receber as informações especificadas.

cbSize

Tamanho fornecido pelo chamador, em bytes, do buffer apontado por pOutput.

pcbNeeded

Ponteiro fornecido pelo chamador para um local para receber o tamanho mínimo do buffer necessário para conter as informações solicitadas.

pdwOptionsReturned

Ponteiro fornecido pelo chamador para um local para receber o número de cadeias de caracteres de opção colocadas em pOutput.

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação
E_NOTIMPL
 O método não está implementado.

Comentários

Quando o IPrintOemDriverPS::DrvGetDriverSetting método é chamado, um ponteiro de cadeia de caracteres ou um valor constante pode ser especificado para pFeatureKeyword.

  • Se pFeatureKeyword for uma cadeia de caracteres, ele deverá representar um argumento palavra-chave para uma entrada *OpenUI em um arquivo PPD do minidriver Pscript5.

    O método deve retornar uma ou mais cadeias de caracteres terminadas em NULL no buffer apontado por pOutput. Cada cadeia de caracteres deve representar o nome de uma opção selecionada no momento. O número de cadeias de caracteres deve ser retornado em pdwOptionsReturned.

  • Se pFeatureKeyword for uma constante, ela deverá ser uma das constantes prefixadas por OEMGDS_ definidas em printoem.h. O método deve retornar o valor indicado pela constante especificada colocando-o no buffer apontado por pOutput. O valor retornado em pdwOptionsReturned deve ser 1.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)