VhfDelete-Funktion (vhf.h)

Artikel
02/26/2024

Der HID Source-Gerätetreiber ruft diese Methode auf, um ein VHF-Gerät zu löschen.

Syntax

void VhfDelete(
  [in] VHFHANDLE VhfHandle,
  [in] BOOLEAN   Wait
);

Parameter

[in] VhfHandle

Ein Handle für ein virtuelles HID-Gerät, das Ihr HID-Quelltreiber im vorherigen Aufruf von VhfCreate empfangen hat.

[in] Wait

TRUE, um synchron nach dem Löschen eines Geräts zurückzugeben. In diesem Fall wird virtual HID Framework (VHF) erst zurückgegeben, wenn das Gerät als fehlt an PnP Manager gemeldet wird und die Rückruffunktion EvtVhfCleanup zurückgibt.

FALSE ist reserviert und sollte nicht übergeben werden. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Keine

Bemerkungen

Der HID-Quelltreiber muss das Initiieren neuer Anforderungen für das Virtual HID Framework (VHF) kurz vor dem Aufruf von VhfDelete beenden.

Um VhfDelete synchron aufzurufen, rufen Sie sie bei PASSIVE_LEVEL auf, wobei der Wait-Parameter auf TRUE festgelegt ist. In diesem Fall wird nach Abschluss des Löschvorgangs synchron zurückgegeben. Wenn der HID-Quelltreiber eine EvtVhfCleanup-Rückruffunktion bei VHF registriert hat, wird dieser Rückruf aufgerufen, bevor VhfDelete zurückgibt. Die Funktion kann im selben Thread aufgerufen werden.

VhfDelete kann nicht asynchron (Wait-Parameter auf FALSE festgelegt) oder bei einem IRQL aufgerufen werden, der höher als PASSIVE_LEVEL ist. Dies kann zu undefiniertem Verhalten führen.

Es gibt keine Einschränkungen, wann ein KMDF-Treiber diese Funktion aufrufen soll. Es wird empfohlen, sie über eine Funktion aufzurufen, die dem Aufruf VhfCreate entspricht. Wenn beispielsweise VhfCreate von EvtDriverDeviceAdd aufgerufen wird, rufen Sie VhfDelete synchron aus EvtDeviceCleanupCallback auf. VhfDelete kann auf einem VHFHANDLE aufgerufen werden, ohne zuvor VhfStart aufgerufen zu haben.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	vhf.h
Bibliothek	VhfKm.lib
IRQL	Wait is TRUE, PASSIVE_LEVEL

Weitere Informationen

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

Freigeben über