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

Artigo
02/07/2025

O método IPrintOemDriverUI::DrvGetDriverSetting é fornecido pelos minidrivers Unidrv e Pscript5 para que os plug-ins de interface do usuário possam obter o status atual dos recursos da impressora e outras informações internas.

Sintaxe

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

Parâmetros

pci

Ponteiro fornecido pelo chamador para uma estrutura de OEMUIOBJ.

Feature

Valor fornecido pelo chamador que identifica o recurso de impressora para o qual as configurações de opção sã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.

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

Ao chamar o método IPrintOemDriverUI::DrvGetDriverSetting, um plug-in de interface do usuário pode especificar um ponteiro de cadeia de caracteres ou um valor constante para pFeatureKeyword.

Se pFeatureKeyword for uma cadeia de caracteres, ela deverá representar uma das seguintes opções:
- Um nome de recurso especificado em um minidriver Unidrv arquivo GPD ou,
- Um argumento de palavra-chave para uma entrada *OpenUI no arquivo PPD de um minidriver Pscript5.
O método retorna uma ou mais cadeias de caracteres terminadas em NULL no buffer apontado por pOutput. Cada cadeia de caracteres representa o nome de uma opção selecionada no momento. O número de cadeias de caracteres é retornado em pdwOptionsReturned .
Se pFeatureKeyword for uma constante, ela deverá ser uma das constantes prefixadas OEMGDS_definidas em printoem.h. O método retorna o valor indicado pela constante especificada colocando-o no buffer apontado por pOutput. O valor retornado em pdwOptionsReturned é sempre 1.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Partilhar via