Função VhfCreate (vhf.h)

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.

Retornar valor

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

Comentários

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 a inicialização do dispositivo podem não ser concluídas antes que esse método retorne.

Um driver do 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 no VHF_CONFIG até que o driver de origem HID chame VhfStart.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	vhf.h
Biblioteca	VhfKm.lib
IRQL	PASSIVE_LEVEL

Confira também

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