Compartilhar via


Função DrvQueryFont (winddi.h)

A função DrvQueryFont é usada pelo GDI para obter a estrutura IFIMETRICS para uma determinada fonte.

Sintaxe

PIFIMETRICS DrvQueryFont(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG_PTR *pid
);

Parâmetros

dhpdev

Manipule para o PDEV do dispositivo físico que identifica um dispositivo físico. O PDEV foi retornado de uma chamada anterior para DrvEnablePDEV.

iFile

Ponteiro para um valor definido pelo driver que identifica um arquivo de fonte de driver. Esse ponteiro é retornado por DrvLoadFontFile. Esse parâmetro é zero para fontes residentes no dispositivo.

iFace

Especifica o índice baseado em um da fonte do driver. O GDI pode consultar o número de fontes da estrutura DEVINFO .

pid

Ponteiro para um local de memória que contém o endereço de um valor definido pelo driver que o GDI passa para DrvFree quando a estrutura IFIMETRICS não é mais necessária. Dependendo de como o driver gerencia a memória, esse valor pode identificar a estrutura, identificar a maneira como ela foi alocada ou não fazer nada.

Valor retornado

O valor retornado é um ponteiro para a estrutura IFIMETRICS que descreve a fonte fornecida se a função for bem-sucedida. Caso contrário, ele é NULL e um código de erro é registrado.

Comentários

O driver preenche a estrutura IFIMETRICS.

A estrutura IFIMETRICS deve permanecer inalterada durante o escopo do PDEV associado.

Se o número de fontes no DEVINFO for -1 e iFace for zero, o driver deverá retornar o número de fontes compatíveis.

DrvQueryFont é necessário para drivers de fonte e drivers que usam fontes específicas do driver ou específicas do dispositivo.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

IFIMETRICS