Метод IWDFDevice::AssignDeviceInterfaceState (wudfddi.h)

Статья
02/07/2025

[ предупреждение: 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-terminated, содержащую имя экземпляра интерфейса устройства. Этот параметр является необязательным. Драйвер может передать 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 (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFDevice

IWDFDevice::CreateDeviceInterface

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