Função DrvSplDeviceCaps (winddiui.h)

Artigo
02/07/2025

A função DrvSplDeviceCaps de uma interface de impressora consulta uma impressora para 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 DC_sinalizadores de XXX, mas deve dar suporte aos listados na tabela a seguir.

Bandeira	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 de 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 de pOutput for NULL, a função deverá retornar apenas o número de elementos de matriz necessários.

Bandeira

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 de 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 de 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 deDEVMODEW que descreve as características atuais do trabalho de impressão. Se NULL, a função deverá usar a estrutura DEVMODEW padrão interna do driver.

Valor de retorno

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

Observações

Para obter descrições dos sinalizadores deXXX DC_, 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
da Plataforma de Destino	Área de trabalho
cabeçalho	winddiui.h (inclua Winddiui.h)

Consulte também

drvDeviceCapabilities

Partilhar via