Função VhfCreate (vhf.h)

Artigo
02/07/2025

O driver de origem HID chama esse método para criar um dispositivo HID virtual.

Sintaxe

NTSTATUS VhfCreate(
  [in]  PVHF_CONFIG VhfConfig,
  [out] VHFHANDLE   *VhfHandle
);

Parâmetros

[in] VhfConfig

Um ponteiro para uma estrutura VHF_CONFIG.

[out] VhfHandle

Um identificador para o novo dispositivo HID virtual.

Valor de retorno

Se a chamada VhfCreate for bem-sucedida, o método retornará STATUS_SUCCESS. Caso contrário, um valor de NTSTATUS apropriado.

Observações

Esse método retorna de forma síncrona depois de validar a estrutura VHF_CONFIG e criar um dispositivo HID virtual. O dispositivo HID virtual só é relatado ao PnP. A inicialização, a instalação e o início do dispositivo podem não ser concluídos antes que esse método retorne.

Um driver kmdf (Kernel-Mode Driver Framework) pode chamar VhfCreate a qualquer momento depois de criar com êxito seu próprio objeto de dispositivo chamando WdfDeviceCreate. O driver pode fazer isso em seu EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

O VHF não invoca nenhuma função de retorno de chamada especificada em VHF_CONFIG até que o driver de origem HID chame VhfStart.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	vhf.h
biblioteca	VhfKm.lib
IRQL	PASSIVE_LEVEL

Consulte também

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

Compartilhar via