EVT_VHF_CLEANUP função de retorno de chamada (vhf.h)

O driver de origem HID implementa esse retorno de chamada de evento para liberar recursos que podem ser alocados pelo driver para o dispositivo HID virtual.

Sintaxe

EVT_VHF_CLEANUP EvtVhfCleanup;

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

Parâmetros

[in] VhfClientContext

Ponteiro para a estrutura de contexto definida pelo driver de origem HID que o driver passou na chamada anterior para VhfCreate para criar o dispositivo HID virtual.

Retornar valor

Nenhum

Comentários

Para excluir o dispositivo HID virtual, o driver de origem HID chama VhfDelete. Essa chamada faz com que o VHF (Virtual HID Framework) invoque o EvtVhfCleanup registrado anteriormente, se a função de retorno de chamada for implementada pelo driver de origem HID. Quando o driver chama VhfDelete com Wait definido como TRUE, EvtVhfCleanup é chamado antes que VhfDelete retorne. Se Wait for FALSE, ele poderá ser chamado a qualquer momento depois que VhfDelete for chamado antes ou depois que VhfDelete retornar.

A chamada dá ao driver de origem HID a oportunidade de liberar recursos alocados para o dispositivo HID virtual quando esse dispositivo é excluído.

O driver de origem HID não deve usar o VHFHANDLE para o dispositivo HID virtual (criado por VhfCreate) após o retorno dessa função de retorno de chamada. Antes de invocar essa função de retorno de chamada, o VHF garante que não haja operações assíncronas pendentes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Área de Trabalho
Cabeçalho	vhf.h
IRQL	<=DISPATCH_LEVEL

Confira também

Gravar um driver de origem HID usando a VHF (Estrutura HID Virtual)