Метод 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

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

IWDFDevice

IWDFDevice::CreateDeviceInterface