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


Метод IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод RetrieveUsbInterface извлекает указанный ИНТЕРФЕЙС USB для USB-устройства.

Синтаксис

HRESULT RetrieveUsbInterface(
  [in]  UCHAR            InterfaceIndex,
  [out] IWDFUsbInterface **ppUsbInterface
);

Параметры

[in] InterfaceIndex

Индекс извлекаемого интерфейса.

[out] ppUsbInterface

Указатель на переменную, получающую указатель на указанный интерфейс IWDFUsbInterface для USB-устройства.

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

RetrieveUsbInterface возвращает одно из следующих значений:

Код возврата Описание
S_OK

RetrieveUsbInterface успешно извлек указанный ИНТЕРФЕЙС USB для USB-устройства.

E_OUTOFMEMORY

Метод RetrieveUsbInterface столкнулся с ошибкой выделения.

Код ошибки, определенный в Winerror.h
Это значение соответствует коду ошибки, возвращенной API WinUsb.

Комментарии

Драйвер может вызвать метод IWDFUsbTargetDevice::GetNumInterfaces , чтобы получить общее количество доступных USB-интерфейсов.

Драйвер может использовать указатель интерфейса, извлекаемого RetrieveUsbInterface , для вызова методов, которые предоставляет интерфейс IWDFUsbInterface . Дополнительные сведения об использовании этих методов см. в статье Работа с USB-интерфейсами в UMDF.

Примеры

Пример кода использования метода RetrieveUsbInterface см. в разделе IWDFUsbTargetFactory::CreateUsbTargetDevice.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfusb.h (включая Wudfusb.h)
DLL WUDFx.dll

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

IWDFUsbInterface

IWDFUsbTargetDevice

IWDFUsbTargetDevice::GetNumInterfaces

USBD_INTERFACE_INFORMATION