Função VhfDelete (vhf.h)

O driver do 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 PnP e EvtVhfCleanup função de retorno de chamada retornar.

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

Valor de retorno

Nenhum

Observações

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 de VhfDelete retornar. A função pode ser invocada no mesmo thread.

VhfDelete não pode ser chamado de forma assíncrona ( parâmetroWait 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
da Plataforma de Destino	Windows
cabeçalho	vhf.h
biblioteca	VhfKm.lib
IRQL	A espera é TRUE, PASSIVE_LEVEL

Consulte também

gravar um driver de origem HID usando o VHF (Virtual HID Framework)