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

Статья
02/07/2025

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

Метод WdfUsbTargetDeviceGetInterface возвращает дескриптор в объект USB-интерфейса платформы, связанный с указанным индексом интерфейса.

Синтаксис

WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
  [in] WDFUSBDEVICE UsbDevice,
  [in] UCHAR        InterfaceIndex
);

Параметры

[in] UsbDevice

Дескриптор объекта USB-устройства, полученный из предыдущего вызова WdfUsbTargetDeviceCreateWithParameters.

[in] InterfaceIndex

Отсчитываемое от нуля значение индекса, указывающее объект USB-интерфейса в текущей конфигурации. Это значение индекса может не совпадать с номером интерфейса, который определяет спецификация USB.

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

WdfUsbTargetDeviceGetInterface возвращает дескриптор объекту USB-интерфейса. Если значение InterfaceIndex недопустимо, этот метод возвращает NULL.

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

Замечания

Дополнительные сведения о методе WdfUsbTargetDeviceGetInterface и целевых объектов ввода-вывода USB см. в целевых объектов usb-ввода-вывода.

Примеры

В следующем примере кода получается дескриптор первого объекта USB-интерфейса, созданного платформой для USB-устройства. Затем этот пример получает количество конечных точек, связанных с объектом интерфейса.

WDFUSBINTERFACE  UsbInterface;
BYTE  numEndpoints;

UsbInterface = WdfUsbTargetDeviceGetInterface(
                                              deviceContext->UsbTargetDevice,
                                              0
                                              );
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfusb.h (include 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)

См. также

WdfUsbTargetDeviceCreateWithParameters

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