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

Artigo
02/07/2025

O método IPrintCoreUI2::DrvGetDriverSetting é fornecido pelo driver Pscript5 do Windows XP para que os plug-ins de interface do usuário Pscript5 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

Esse 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

Esse método é herdado do de interface COM do IPrintOemDriverUIe pode ser chamado somente por plug-ins da interface do usuário do Windows XP e posteriores Pscript5 que não substituem totalmente as páginas de interface do usuário padrão do driver principal, e tem suporte durante o IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets funções e suas rotinas de retorno de chamada da folha de propriedades. Quando esse método tem suporte, ele tem o mesmo comportamento que IPrintOemDriverUI::D rvGetDriverSetting. Quando não há suporte, esse método deve retornar E_NOTIMPL.