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

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

  • Статья

[Применимо к KMDF и UMDF]

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

Заметка

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

Синтаксис

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

Параметры

[in] Device

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

[in] InterfaceClassGUID

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

[in, optional] ReferenceString

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

[in] IsInterfaceEnabled

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

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

Никакой

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Дополнительные сведения об интерфейсах устройств и методе WdfDeviceSetDeviceInterfaceStat e см. в использовании интерфейсов устройств.

Примеры

В следующем примере кода отключается интерфейс COM-порта драйвера.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

Требования

Требование Ценность
целевая платформа Всеобщий
минимальная версия KMDF 1.0
минимальная версия UMDF 2.0
заголовка wdfdevice.h (include Wdf.h)
библиотеки Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
правил соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx