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 que falta en PnP Manager y la función de devolución de llamada EvtVhfCleanup devuelve.

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

Valor devuelto

None

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 de forma sincrónica, llámelo en PASSIVE_LEVEL con el parámetro Wait establecido en TRUE. En este caso, devuelve sincrónicamente después de completar la eliminación. Si el controlador de origen HID ha registrado una función de devolución de llamada EvtVhfCleanup con VHF, invoca esa devolución de llamada antes de que se devuelva VhfDelete . La función se puede invocar en el mismo subproceso.

No se puede llamar a VhfDelete 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 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

Consulte también

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