EVT_VHF_CLEANUP Rückruffunktion (vhf.h)

Der HID-Quelltreiber implementiert diesen Ereignisrückruf, um Ressourcen freizugeben, die der Treiber dem virtuellen HID-Gerät zugeordnet ist.

Syntax

EVT_VHF_CLEANUP EvtVhfCleanup;

void EvtVhfCleanup(
  [in] PVOID VhfClientContext
)
{...}

Parameter

[in] VhfClientContext

Zeiger auf die vom HID-Quelltreiber definierte Kontextstruktur, die der Treiber im vorherigen Aufruf von VhfCreate übergeben hat, um das virtuelle HID-Gerät zu erstellen.

Rückgabewert

Keine

Bemerkungen

Um das virtuelle HID-Gerät zu löschen, ruft der HID-Quelltreiber VhfDelete auf. Dieser Aufruf bewirkt, dass Virtual HID Framework (VHF) das zuvor registrierte EvtVhfCleanup aufruft, wenn die Rückruffunktion vom HID-Quelltreiber implementiert wird. Wenn der Treiber VhfDelete aufruft, wobei Wait auf TRUE festgelegt ist, wird EvtVhfCleanup aufgerufen, bevor VhfDelete zurückgegeben wird. Wenn Wait auf FALSE festgelegt ist, kann es jederzeit nach dem Aufruf von VhfDelete aufgerufen werden, d. h. vor oder nach der Rückgabe von VhfDelete .

Der Aufruf gibt dem HID-Quelltreiber die Möglichkeit, Ressourcen freizugeben, die dem virtuellen HID-Gerät zugeordnet sind, wenn dieses Gerät gelöscht wird.

Der HID-Quelltreiber darf die VHFHANDLE nicht für das virtuelle HID-Gerät (erstellt von VhfCreate) verwenden, nachdem diese Rückruffunktion zurückgegeben wurde. Vor dem Aufrufen dieser Rückruffunktion stellt VHF sicher, dass keine asynchronen Vorgänge ausstehen.

Anforderungen

Weitere Informationen

Schreiben eines HID-Quelltreibers mithilfe von Virtual HID Framework (VHF)