Метод 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 возвращает одно из следующих значений:

Замечания

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

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

Примеры

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

Требования

См. также

IWDFUsbInterface

IWDFUsbTargetDevice

IWDFUsbTargetDevice::GetNumInterfaces

USBD_INTERFACE_INFORMATION