Функция WdfDeviceSetDeviceInterfaceStateEx (wdfdevice.h)

Статья
02/29/2024

Метод WdfDeviceSetDeviceInterfaceStateEx включает или отключает интерфейс устройства для указанного устройства.

Синтаксис

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

Параметры

Device

Дескриптор объекта устройства платформы.

InterfaceClassGUID

Указатель на GUID, который идентифицирует класс интерфейса устройства.

ReferenceString

Указатель на структуру UNICODE_STRING , описывающую строку ссылки для интерфейса устройства. Этот параметр является необязательным и может иметь значение NULL.

IsInterfaceEnabled

Логическое значение, которое, если значение TRUE, включает указанный экземпляр интерфейса устройства или, если значение FALSE, отключает его.

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

None

Remarks

Драйвер может вызывать эту функцию до или после запуска устройства.

При вызове перед запуском устройства (например, из EvtDriverDeviceAdd, EvtChildListCreateDevice или EvtDevicePrepareHardware) драйвер должен установить для параметра IsInterfaceEnabled значение FALSE, чтобы предотвратить автоматическое включение интерфейса во время запуска PnP. Установка параметра в значение TRUE перед запуском устройства является избыточной, и такой вызов следует удалить.

При вызове после запуска устройства поведение аналогично WdfDeviceSetDeviceInterfaceState.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 2004
Минимальная версия KMDF	1.31
Минимальная версия UMDF	1.31
Верхняя часть	wdfdevice.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

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

WdfDeviceSetDeviceInterfaceState

Включение и отключение интерфейса устройства

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