Función VhfDelete (vhf.h)

El controlador de dispositivo de origen HID llama a este método para eliminar un dispositivo VHF.

Sintaxis

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

Parámetros

[in] VhfHandle

Identificador de un dispositivo HID virtual que el controlador de origen HID recibió en la llamada anterior a VhfCreate.

[in] Wait

TRUE para devolver de forma sincrónica después de eliminar un dispositivo. En este caso, Virtual HID Framework (VHF) no devuelve hasta que el dispositivo se notifica como que falta en PnP Manager y EvtVhfCleanup función de devolución de llamada devuelve.

FALSE está reservado y no debe pasarse. Vea Comentarios para obtener más información.

Valor devuelto

Ninguno

Observaciones

El controlador de origen HID debe dejar de iniciar nuevas solicitudes para virtual HID Framework (VHF) justo antes de llamar a VhfDelete.

Para llamar a VhfDelete sincrónicamente, llámelo en PASSIVE_LEVEL con el parámetro Wait establecido en TRUE. En este caso, devuelve de forma sincrónica después de completar la eliminación. Si el controlador de origen HID ha registrado un EvtVhfCleanup función de devolución de llamada con VHF, invoca esa devolución de llamada antes de que VhfDelete. Es posible que se invoque la función en el mismo subproceso.

VhfDelete no se puede llamar de forma asincrónica (parámetro Wait establecido en FALSE) o en cualquier IRQL superior a PASSIVE_LEVEL. Si lo hace, puede dar lugar a un comportamiento indefinido.

No hay restricciones en cuando un controlador KMDF debe llamar a esta función. Se recomienda llamarlo desde una función que coincida con la llamada de VhfCreate. Por ejemplo, si se llama a VhfCreate desde EvtDriverDeviceAdd, llame a VhfDelete sincrónicamente desde EvtDeviceCleanupCallback. se puede llamar a VhfDelete en un VHFHANDLE sin haber llamado previamente a VhfStart.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	vhf.h
biblioteca de	VhfKm.lib
irQL	Wait es TRUE, PASSIVE_LEVEL

Consulte también

Escribir un controlador de origen HID mediante virtual HID Framework (VHF)