VhfDelete-Funktion (vhf.h)

Artikel
02/07/2025

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 zu einem virtuellen HID-Gerät, das Ihr HID-Quelltreiber im vorherigen Aufruf von VhfCreateempfangen hat.

[in] Wait

TRUE, das nach dem Löschen eines Geräts synchron zurückgegeben wird. In diesem Fall gibt Virtual HID Framework (VHF) erst zurück, wenn das Gerät als fehlender PnP-Manager gemeldet wird, und EvtVhfCleanup Rückruffunktion zurückgegeben wird.

FALSE ist reserviert und sollte nicht übergeben werden. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Nichts

Bemerkungen

Der HID-Quelltreiber muss das Initiieren neuer Anforderungen für das Virtual HID Framework (VHF) unmittelbar vor dem Aufrufen VhfDeletebeenden.

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

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

Es gibt keine Einschränkungen, wenn ein KMDF-Treiber diese Funktion aufrufen soll. Es wird empfohlen, sie von einer Funktion aufzurufen, die dem VhfCreate Aufruf entspricht. Wenn z. B. VhfCreate von EvtDriverDeviceAddaufgerufen wird, rufen Sie VhfDelete synchron von EvtDeviceCleanupCallbackauf. VhfDelete kann für eine VHFHANDLE aufgerufen werden, ohne zuvor VhfStartaufgerufen zu haben.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	vhf.h
Library	VhfKm.lib
IRQL-	Wait is TRUE, PASSIVE_LEVEL

Siehe auch

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

Freigeben über