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