Função DrvQueryAdvanceWidths (winddi.h)

Artigo
08/27/2023

A função DrvQueryAdvanceWidths retorna larguras de avanço de caractere para um conjunto especificado de glifos.

Sintaxe

BOOL DrvQueryAdvanceWidths(
        DHPDEV  dhpdev,
        FONTOBJ *pfo,
        ULONG   iMode,
  [in]  HGLYPH  *phg,
  [out] PVOID   pvWidths,
        ULONG   cGlyphs
);

Parâmetros

dhpdev

Identificador para o PDEV do dispositivo físico que foi retornado anteriormente por DrvEnablePDEV.

pfo

Ponteiro para uma estrutura FONTOBJ que identifica a instância de fonte.

iMode

Especifica o tipo de informação a ser fornecido. Esse parâmetro pode usar um dos valores a seguir:

Valor	Significado
QAW_GETEASYWIDTHS	As larguras de avanço de caractere são retornadas como uma matriz de 12,4 números de ponto fixo. Esse modo não será usado se as larguras excederem o intervalo da representação de 12,4. Essa rotina deve calcular larguras o mais rápido possível. Se a computação da largura avançada do caractere de um glifo não puder ser realizada com eficiência, o driver deverá gravar 0xFFFF no buffer para esse glifo. A função retornará DDI_ERROR se ocorrer um erro, FALSE se nem todas as larguras puderem ser computadas com eficiência para esse modo ou TRUE em todos os outros casos.
QAW_GETWIDTHS	As larguras de avanço de caractere são registradas como uma matriz de 12,4 números de ponto fixo. Esse modo não será usado se as larguras excederem o intervalo da representação de 12,4. A função retornará TRUE se tiver êxito.

Valor

Significado

QAW_GETEASYWIDTHS

As larguras de avanço de caractere são retornadas como uma matriz de 12,4 números de ponto fixo. Esse modo não será usado se as larguras excederem o intervalo da representação de 12,4. Essa rotina deve calcular larguras o mais rápido possível. Se a computação da largura avançada do caractere de um glifo não puder ser realizada com eficiência, o driver deverá gravar 0xFFFF no buffer para esse glifo. A função retornará DDI_ERROR se ocorrer um erro, FALSE se nem todas as larguras puderem ser computadas com eficiência para esse modo ou TRUE em todos os outros casos.

QAW_GETWIDTHS

As larguras de avanço de caractere são registradas como uma matriz de 12,4 números de ponto fixo. Esse modo não será usado se as larguras excederem o intervalo da representação de 12,4. A função retornará TRUE se tiver êxito.

[in] phg

Ponteiro para uma matriz de identificadores de glifo que especificam os glifos para os quais o driver retornará larguras avançadas de caracteres.

[out] pvWidths

Ponteiro para um buffer em que o driver gravará dados.

cGlyphs

Especifica o número de glifos no buffer de entrada apontado por phg.

Valor retornado

O valor retornado depende do valor do parâmetro iMode .

Requisitos


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

Confira também

DrvEnablePDEV

FONTOBJ

Compartilhar via