Funzione VhfDelete (vhf.h)

Articolo
02/07/2025

Il driver di dispositivo di origine HID chiama questo metodo per eliminare un dispositivo VHF.

Sintassi

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

Parametri

[in] VhfHandle

Handle per un dispositivo HID virtuale ricevuto dal driver di origine HID nella chiamata precedente a VhfCreate.

[in] Wait

TRUE per restituire in modo sincrono dopo l'eliminazione di un dispositivo. In questo caso, Virtual HID Framework (VHF) non restituisce finché il dispositivo non viene segnalato come mancante a PnP Manager e EvtVhfCleanup funzione di callback restituisce.

FALSE è riservato e non deve essere passato. Per altre informazioni, vedere La sezione Osservazioni.

Valore restituito

Nessuno

Osservazioni

Il driver di origine HID deve interrompere l'avvio di nuove richieste per Virtual HID Framework (VHF) subito prima di chiamare VhfDelete.

Per chiamare VhfDelete in modo sincrono, chiamarlo in PASSIVE_LEVEL con il parametro wait impostato su TRUE. In questo caso, viene restituito in modo sincrono dopo aver completato l'eliminazione. Se il driver di origine HID ha registrato un EvtVhfCleanup funzione di callback con VHF, richiama tale callback prima di VhfDelete. La funzione potrebbe essere richiamata sullo stesso thread.

VhfDelete non può essere chiamato in modo asincrono ( parametroWait impostato su FALSE) o in qualsiasi irQL superiore a PASSIVE_LEVEL. In questo modo può verificarsi un comportamento non definito.

Non esistono restrizioni per quando un driver KMDF deve chiamare questa funzione. È consigliabile chiamarlo da una funzione corrispondente alla chiamata VhfCreate. Ad esempio, se VhfCreate viene chiamato da EvtDriverDeviceAdd, chiamare VhfDelete in modo sincrono da EvtDeviceCleanupCallback. VhfDelete può essere chiamato in VHFHANDLE senza chiamare in precedenza VhfStart.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	vhf.h
libreria	VhfKm.lib
IRQL	L'attesa è TRUE, PASSIVE_LEVEL

Vedere anche

scrivere un driver di origine HID usando VHF (Virtual HID Framework)

Condividi tramite