Função VhfDelete (vhf.h)

O driver de dispositivo de origem HID chama esse método para excluir um dispositivo VHF.

Sintaxe

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

Parâmetros

[in] VhfHandle

Um identificador para um dispositivo HID virtual que o driver de origem hid recebeu na chamada anterior para VhfCreate.

[in] Wait

TRUE para retornar de forma síncrona depois de excluir um dispositivo. Nesse caso, o VHF (Virtual HID Framework) não retorna até que o dispositivo seja relatado como ausente no Gerenciador de PnP e a função de retorno de chamada EvtVhfCleanup retorne.

FALSE é reservado e não deve ser passado. Confira Comentários para obter mais informações.

Retornar valor

Nenhum

Comentários

O driver de origem HID deve parar de iniciar novas solicitações para o VHF (Virtual HID Framework) pouco antes de chamar VhfDelete.

Para chamar VhfDelete de forma síncrona, chame-o em PASSIVE_LEVEL com o parâmetro Wait definido como TRUE. Nesse caso, ele retorna de forma síncrona depois de concluir a exclusão. Se o driver de origem HID tiver registrado uma função de retorno de chamada EvtVhfCleanup com VHF, ele invocará esse retorno de chamada antes que VhfDelete retorne. A função pode ser invocada no mesmo thread.

VhfDelete não pode ser chamado de forma assíncrona (Parâmetro de espera definido como FALSE) ou em qualquer IRQL maior que PASSIVE_LEVEL. Isso pode resultar em um comportamento indefinido.

Não há restrições sobre quando um driver KMDF deve chamar essa função. É recomendável chamá-lo de uma função que corresponda à chamada VhfCreate . Por exemplo, se VhfCreate for chamado de EvtDriverDeviceAdd, chame VhfDelete de forma síncrona de EvtDeviceCleanupCallback. VhfDelete pode ser chamado em um VHFHANDLE sem ter chamado anteriormente VhfStart.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	vhf.h
Biblioteca	VhfKm.lib
IRQL	A espera é TRUE, PASSIVE_LEVEL

Confira também

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