Функция 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, отключает его.

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

None

Remarks

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

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

Примеры

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

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx