Funzione VhfDelete (vhf.h)

Articolo
02/29/2024

Il driver di dispositivo hid di origine 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 la funzione di callback EvtVhfCleanup restituisce.

FALSE è riservato e non deve essere passato. Per ulteriori 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) appena prima di chiamare VhfDelete.

Per chiamare VhfDelete in modo sincrono, chiamarlo in PASSIVE_LEVEL con il parametro Wait impostato su TRUE. In questo caso, restituisce in modo sincrono dopo aver completato l'eliminazione. Se il driver di origine HID ha registrato una funzione di callback EvtVhfCleanup con VHF, richiama tale callback prima che VhfDelete restituisca . La funzione può essere richiamata sullo stesso thread.

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

Quando un driver KMDF deve chiamare questa funzione, non sono previste restrizioni. È 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 aver precedentemente chiamato VhfStart.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	vhf.h
Libreria	VhfKm.lib
IRQL	Wait è TRUE, PASSIVE_LEVEL

Vedi anche

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

Condividi tramite