Функция WdfUsbInterfaceGetDescriptor (wdfusb.h)

  • Статья

[Применимо к KMDF и UMDF]

Метод WdfUsbInterfaceGetDescriptor извлекает дескриптор интерфейса USB, связанный с указанным альтернативным параметром указанного ИНТЕРФЕЙСА USB.

Синтаксис

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Параметры

[in] UsbInterface

Дескриптор объекта интерфейса USB, полученный путем вызова WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Значение индекса, определяющее альтернативный параметр для интерфейса. Дополнительные сведения об альтернативных параметрах см. в спецификации USB.

[out] InterfaceDescriptor

Указатель на структуру, выделенную вызывающим объектом USB_INTERFACE_DESCRIPTOR , заполняемую платформой.

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

None

Remarks

Если значение SettingIndex недопустимо, структура USB_INTERFACE_DESCRIPTOR может получать недопустимые данные.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Дополнительные сведения о методе WdfUsbInterfaceGetDescriptor и целевых объектах USB-ввода-вывода см. в разделе Usb I/O Targets.

Примеры

В следующем примере кода получается альтернативный индекс параметров для указанного ИНТЕРФЕЙСА USB. Затем в примере получается дескриптор интерфейса USB, представляющий текущий альтернативный параметр интерфейса USB.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfusb.h (включая Wdfusb.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

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

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface