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

Статья
10/26/2023

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

Синтаксис

void VhfDelete(
  [in] VHFHANDLE VhfHandle,
  [in] BOOLEAN   Wait
);

Параметры

[in] VhfHandle

Дескриптор виртуального устройства HID, полученного драйвером источника HID в предыдущем вызове VhfCreate.

[in] Wait

True для синхронного возврата после удаления устройства. В этом случае виртуальная платформа HID Framework (VHF) не возвращается, пока устройство не будет передано диспетчеру PnP как отсутствующим, а функция обратного вызова EvtVhfCleanup возвращается.

Значение FALSE зарезервировано и не должно передаваться. Дополнительные сведения см. в разделе "Примечания".

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

None

Remarks

Драйвер источника HID должен прекратить инициализацию новых запросов для виртуальной платформы HID (VHF) непосредственно перед вызовом VhfDelete.

Чтобы вызвать VhfDelete синхронно, вызовите его в PASSIVE_LEVEL с параметром Wait , равным TRUE. В этом случае он возвращается синхронно после завершения удаления. Если исходный драйвер HID зарегистрировал функцию обратного вызова EvtVhfCleanup с VHF, он вызывает этот обратный вызов перед возвратом VhfDelete . Функция может вызываться в том же потоке.

VhfDelete не может вызываться асинхронно (параметр ожидания имеет значение FALSE) или при любом irQL выше PASSIVE_LEVEL. Это может привести к неопределенному поведению.

Нет ограничений на то, когда драйвер KMDF должен вызывать эту функцию. Рекомендуется вызывать его из функции, соответствующей вызову VhfCreate . Например, если VhfCreate вызывается из EvtDriverDeviceAdd, вызовите VhfDelete синхронно из EvtDeviceCleanupCallback. VhfDelete можно вызывать в VHFHANDLE без предварительного вызова VhfStart.

Требования

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

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

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

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