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

[Относится к 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
                                              );

Требования

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

WdfUsbTargetDeviceCreateWithParameters