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

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

Синтаксис

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

Параметры

Device

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

InterfaceClassGUID

Указатель на GUID, определяющий класс интерфейса устройства.

ReferenceString

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

IsInterfaceEnabled

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

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

Никакой

Замечания

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

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

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

Требования

См. также

WdfDeviceSetDeviceInterfaceState

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