DrvFree-Funktion (winddi.h)
Die DrvFree-Funktion wird verwendet, um den Treiber zu benachrichtigen, dass die angegebene Struktur nicht mehr benötigt wird.
Syntax
void DrvFree(
PVOID pv,
ULONG_PTR id
);
Parameter
pv
Zeiger auf die Struktur, deren Arbeitsspeicher freigegeben werden soll.
id
Zeiger auf den Bezeichner, der mit der -Struktur zurückgegeben wurde.
Rückgabewert
Keine
Bemerkungen
DrvFree ist eine optionale Funktion, die nur unterstützt werden sollte, wenn der Treiber informiert werden muss, wenn der mit Strukturen verknüpfte Arbeitsspeicher freigegeben werden kann. Wenn beispielsweise eine FONTOBJ-Struktur verwendet wird, kann das Löschen zurückgestellt werden, bis DrvDestroyFont aufgerufen wurde, sodass der Treiber DrvFree nicht mehr implementieren muss.
Ein Treiber kann id auf unterschiedliche Weise verwenden. Es kann ein Objekthandle angeben oder die Art und Weise angeben, wie die Struktur zugeordnet wird. Sie kann beispielsweise zwischen geladenen Ressourcen und dem Speicher unterscheiden, der aus einem Heap zugeordnet wird. Der Treiber kann diesen Parameter ignorieren, wenn die Struktur, auf die pv verweist, genügend Informationen enthält.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | winddi.h (einschließlich Winddi.h) |