Função DrvSplDeviceCaps (winddiui.h)

A função DrvSplDeviceCaps de uma interface de impressora consulta uma impressora para obter seus recursos.

Sintaxe

DWORD DrvSplDeviceCaps(
                  HANDLE   hPrinter,
  [in]            PWSTR    pszDeviceName,
                  WORD     Capability,
  [out, optional] PVOID    pOutput,
                  DWORD    cchBufSize,
  [in, optional]  PDEVMODE pDevmode
);

Parâmetros

hPrinter

Identificador fornecido pelo chamador para a impressora.

[in] pszDeviceName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres Unicode que contém o nome da impressora.

Capability

Sinalizador de bit fornecido pelo chamador que indica a capacidade de consulta. (Os sinalizadores são definidos no arquivo de cabeçalho wingdi.h.) Essa função não é necessária para dar suporte a todos os sinalizadores DC_XXX , mas deve dar suporte aos listados na tabela a seguir.

Sinalizador	Definição
DC_MEDIAREADY	O parâmetro pOutput aponta para um buffer que a função deve preencher com uma matriz de buffers de cadeia de caracteres, cada um com 64 caracteres de comprimento. Cada elemento de matriz deve conter uma cadeia de caracteres terminada em NULL que representa um nome para um formulário de papel disponível para uso. O valor retornado da função deve ser o número de elementos na matriz retornada. Se pOutput for NULL, a função deverá retornar apenas o número de elementos de matriz necessários.
DC_PAPERNAMES	O parâmetro pOutput aponta para um buffer que a função deve preencher com uma matriz de buffers de cadeia de caracteres, cada um com 64 caracteres de comprimento. Cada elemento de matriz deve conter uma cadeia de caracteres terminada em NULL que representa um nome para um formulário de papel. O valor retornado da função deve ser o número de elementos na matriz retornada. Se pOutput for NULL, a função deverá retornar apenas o número de elementos de matriz necessários.

[out, optional] pOutput

Ponteiro fornecido pelo chamador para um buffer que recebe informações fornecidas pela função. O uso do buffer depende do valor do parâmetro Capability . O chamador é responsável por alocar e liberar esse buffer.

cchBufSize

Tamanho fornecido pelo chamador (em caracteres) do buffer apontado pelo parâmetro pOutput .

[in, optional] pDevmode

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW que descreve as características atuais do trabalho de impressão. Se FOR NULL, a função deverá usar a estrutura DEVMODEW padrão interna do driver.

Retornar valor

O valor retornado depende do parâmetro Capability . Se Capability indicar uma funcionalidade que o driver não dá suporte ou se um erro for encontrado, a função deverá retornar GDI_ERROR.

Comentários

Para obter descrições dos sinalizadores DC_XXX , consulte DrvDeviceCapabilities.

Essa função deve ser definida no arquivo .def como DrvSplDeviceCaps @ 254, pois o spooler usa o número ordinal 254 para obter o ponteiro da função de driver.

Requisitos

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

Confira também

DrvDeviceCapabilities