Функция VhfCreate (vhf.h)

Драйвер источника HID вызывает этот метод для создания виртуального устройства HID.

Синтаксис

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

Параметры

[in] VhfConfig

Указатель на структуру VHF_CONFIG .

[out] VhfHandle

Дескриптор нового виртуального устройства HID.

Возвращаемое значение

Если вызов VhfCreate завершается успешно, метод возвращает STATUS_SUCCESS. В противном случае соответствующее значение NTSTATUS .

Комментарии

Этот метод возвращается синхронно после проверки структуры VHF_CONFIG и создания виртуального устройства HID. Виртуальное устройство HID передается только в PnP. Инициализация, установка и запуск устройства могут не завершиться до возврата этого метода.

Драйвер Kernel-Mode Driver Framework (KMDF) может вызывать VhfCreate в любой момент после успешного создания собственного объекта устройства путем вызова WdfDeviceCreate. Драйвер может сделать это в evtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF не вызывает функции обратного вызова, указанные в VHF_CONFIG , пока драйвер источника HID не вызовет VhfStart.

Требования

Требование	Значение
Целевая платформа	Windows
Header	vhf.h
Библиотека	VhfKm.lib
IRQL	PASSIVE_LEVEL

См. также раздел

Создание исходного драйвера HID с помощью Виртуальной платформы HID (VHF)