Funzione DrvQueryFont (winddi.h)

Articolo
03/15/2023

La funzione DrvQueryFont viene usata da GDI per ottenere la struttura IFIMETRICS per un determinato tipo di carattere.

Sintassi

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

Parametri

dhpdev

Gestire il pdev del dispositivo fisico che identifica un dispositivo fisico. Il PDEV è stato restituito da una precedente chiamata a DrvEnablePDEV.

iFile

Puntatore a un valore definito dal driver che identifica un file di carattere del driver. Questo puntatore viene restituito da DrvLoadFontFile. Questo parametro è zero per i tipi di carattere residenti nel dispositivo.

iFace

Specifica l'indice in base uno del tipo di carattere del driver. GDI può eseguire query sul numero di tipi di carattere dalla struttura DEVINFO .

pid

Puntatore a una posizione di memoria contenente l'indirizzo di un valore definito dal driver che GDI passa a DrvFree quando la struttura IFIMETRICS non è più necessaria. A seconda del modo in cui il driver gestisce la memoria, questo valore può identificare la struttura, identificare la modalità di allocazione o eseguire alcuna operazione.

Valore restituito

Il valore restituito è un puntatore alla struttura IFIMETRICS che descrive il tipo di carattere specificato se la funzione ha esito positivo. In caso contrario, è NULL e viene registrato un codice di errore.

Commenti

Il driver riempie la struttura IFIMETRICS.

La struttura IFIMETRICS deve rimanere invariata durante l'ambito del PDEV associato.

Se il numero di tipi di carattere in DEVINFO è -1 e iFace è zero, il driver deve restituire il numero di tipi di carattere supportati.

DrvQueryFont è necessario per driver e driver di tipo di carattere che usano tipi di carattere specifici del driver o specifici del dispositivo.

Requisiti


Piattaforma di destinazione	Desktop
Intestazione	winddi.h (include Winddi.h)

Vedi anche