EVT_VHF_CLEANUP función de devolución de llamada (vhf.h)

El controlador de origen HID implementa esta devolución de llamada de evento para liberar recursos que podrían asignar el controlador al dispositivo HID virtual.

Sintaxis

EVT_VHF_CLEANUP EvtVhfCleanup;

void EvtVhfCleanup(
  [in] PVOID VhfClientContext
)
{...}

Parámetros

[in] VhfClientContext

Puntero a la estructura de contexto definida por el controlador de origen HID que el controlador pasó en la llamada anterior a VhfCreate para crear el dispositivo HID virtual.

Valor devuelto

Ninguno

Observaciones

Para eliminar el dispositivo HID virtual, el controlador de origen HID llama a VhfDelete. Esa llamada hace que Virtual HID Framework (VHF) invoque el EvtVhfCleanup previamente registrado, si el controlador de origen hid implementa la función de devolución de llamada. Cuando el controlador llama a VhfDelete con Wait establecido en TRUE, se llama a EvtVhfCleanup antes de que se devuelva VhfDelete. Si wait es FALSE, es posible que se llame a ella en cualquier momento después de que se llame a VhfDelete antes o después de que se devuelva VhfDelete.

La llamada proporciona al controlador de origen HID una oportunidad para liberar recursos asignados para el dispositivo HID virtual cuando se elimina ese dispositivo.

El controlador de origen HID no debe usar VHFHANDLE para el dispositivo HID virtual (creado por VhfCreate) después de que se devuelva esta función de devolución de llamada. Antes de invocar esta función de devolución de llamada, VHF se asegura de que no haya ninguna operación asincrónica pendiente.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	No se admite ninguna
de la plataforma de destino de	Escritorio
encabezado de	vhf.h
irQL	<=DISPATCH_LEVEL

Consulte también

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