EVT_VHF_CLEANUP Rückruffunktion (vhf.h)

Der HID-Quelltreiber implementiert diesen Ereignisrückruf auf kostenlose Ressourcen, die dem virtuellen HID-Gerät zugewiesen werden können.

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) die zuvor registrierte EvtVhfCleanup aufruft, wenn die Rückruffunktion vom HID-Quelltreiber implementiert wird. Wenn der Treiber VhfDelete mit " Wait set" auf TRUE aufruft, wird EvtVhfCleanup aufgerufen, bevor VhfDelete zurückgibt . Wenn "Wait " falsch ist, wird er möglicherweise jederzeit aufgerufen, nachdem VhfDelete aufgerufen wird, das vor oder nach dem Zurückgeben von VhfDelete aufgerufen wird.

Der Aufruf gibt dem HID-Quelltreiber die Möglichkeit, Ressourcen freizugeben, die für das virtuelle HID-Gerät zugewiesen sind, wenn dieses Gerät gelöscht wird.

Der HID-Quelltreiber darf den VHFHANDLE nicht für das virtuelle HID-Gerät (erstellt von VhfCreate) verwenden, nachdem diese Rückruffunktion zurückgegeben wird. Bevor Sie diese Rückruffunktion aufrufen, stellt VHF sicher, dass keine asynchronen Vorgänge ausstehen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Power BI Desktop
Header	vhf.h
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

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