Fonction DrvFree (winddi.h)

Article
03/04/2024

La fonction DrvFree est utilisée pour informer le pilote que la structure spécifiée n’est plus nécessaire.

Syntaxe

void DrvFree(
  PVOID     pv,
  ULONG_PTR id
);

Paramètres

pv

Pointeur vers la structure dont la mémoire doit être libérée.

id

Pointeur vers l’identificateur retourné avec la structure.

Valeur de retour

None

Remarques

DrvFree est une fonction facultative qui doit être prise en charge uniquement si le pilote doit être informé lorsque la mémoire associée aux structures peut être libérée. Par exemple, si une structure FONTOBJ est en cours d’utilisation, la suppression peut être différée jusqu’à ce que DrvDestroyFont ait été appelé, ce qui élimine la nécessité pour le pilote d’implémenter DrvFree.

Un pilote peut utiliser id de différentes manières. Il peut spécifier un handle d’objet ou indiquer la façon dont la structure est allouée. Par exemple, il peut faire la différence entre les ressources chargées et la mémoire allouée à partir d’un tas. Le pilote peut ignorer ce paramètre si la structure pointée par pv contient suffisamment d’informations.