Метод IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Метод AssignDeviceInterfaceState включает или отключает указанный экземпляр интерфейса устройства для устройства.
Синтаксис
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
Параметры
[in] pDeviceInterfaceGuid
Указатель на GUID для класса интерфейса устройства.
[in, optional] pReferenceString
Указатель на строку, завершающуюся значением NULL, которая содержит имя экземпляра интерфейса устройства. Этот параметр является необязательным. Драйвер может передать значение NULL , если драйвер не должен указывать имя. Если драйвер должен указать имя, строка, которую передает драйвер, не должна содержать символы-разделители пути ("/" или "\").
[in] Enable
Значение BOOL, указывающее, следует ли включить или отключить экземпляр интерфейса устройства. Значение TRUE указывает, что необходимо включить; Значение FALSE указывает на отключение.
Возвращаемое значение
AssignDeviceInterfaceState возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Комментарии
Если IWDFDevice::CreateDeviceInterface завершается успешно, платформа автоматически включает и отключает интерфейс в зависимости от состояния PnP устройства.
Используйте метод AssignDeviceInterfaceState , чтобы отключить и повторно включить интерфейс устройства вручную.
Дополнительные сведения об интерфейсах устройств см. в разделе Использование интерфейсов устройств в драйверах UMDF.
Примеры
Пример кода использования метода AssignDeviceInterfaceState см. в разделе IWDFDevice::CreateDeviceInterface.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1.5 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |
| DLL | WUDFx.dll |