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

  • Статья

[Относится к KMDF и UMDF]

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

Синтаксис

BYTE WdfUsbInterfaceGetNumEndpoints(
  [in] WDFUSBINTERFACE UsbInterface,
  [in] UCHAR           SettingIndex
);

Параметры

[in] UsbInterface

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

[in] SettingIndex

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

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

Если указанный индекс является допустимым, WdfUsbInterfaceGetNumEndpoints возвращает количество конечных точек, связанных с альтернативным параметром указанного интерфейса. В противном случае метод возвращает ноль.

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

Комментарии

Дополнительные сведения о методе WdfUsbInterfaceGetNumEndpoints и целевых объектах ВВОДА-вывода USB см. в разделе Целевые объекты ввода-вывода USB.

Примеры

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

BYTE  numEndpoints;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия 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)

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

WdfUsbTargetDeviceGetInterface