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

Статья
02/07/2025

Драйвер источника 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.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	vhf.h
библиотеки	VhfKm.lib
IRQL	PASSIVE_LEVEL

См. также

Написание исходного драйвера HID с помощью Virtual HID Framework (VHF)

Поделиться через