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 de VHF_CONFIG .

[out] VhfHandle

Identificador del nuevo dispositivo HID virtual.

Valor devuelto

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

Comentarios

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

Consulte también

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