Función VhfCreate (vhf.h)

El controlador de origen HID llama a este método para crear un dispositivo HID virtual.

Sintaxis

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

Parámetros

[in] VhfConfig

Puntero a una estructura VHF_CONFIG.

[out] VhfHandle

Identificador del nuevo dispositivo HID virtual.

Valor devuelto

Si el VhfCreate llamada se realiza correctamente, el método devuelve STATUS_SUCCESS. De lo contrario, un valor de NTSTATUS adecuado.

Observaciones

Este método devuelve de forma sincrónica después de validar la estructura de VHF_CONFIG y crear un dispositivo HID virtual. El dispositivo HID virtual solo se notifica a PnP. Es posible que la inicialización, la instalación y el inicio del dispositivo no se completen antes de que este método devuelva.

Un controlador de Kernel-Mode Driver Framework (KMDF) puede llamar a VhfCreate en cualquier momento después de crear correctamente su propio objeto de dispositivo llamando a WdfDeviceCreate. El controlador puede hacerlo en su EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF no invoca ninguna función de devolución de llamada especificada en VHF_CONFIG hasta que el controlador de origen HID llame a VhfStart.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	vhf.h
biblioteca de	VhfKm.lib
irQL	PASSIVE_LEVEL

Consulte también

Escribir un controlador de origen HID mediante virtual HID Framework (VHF)