функция обратного вызова PUSB_BUSIFFN_QUERY_BUS_INFORMATION (usbbusif.h)

  • Статья

Подпрограмма QueryBusInformation получает сведения о шине.

Синтаксис

typedef NTSTATUS
  (USB_BUSIFFN *PUSB_BUSIFFN_QUERY_BUS_INFORMATION) (
    IN PVOID,
    IN ULONG,
    IN OUT PVOID,
    IN OUT PULONG,
    OUT PULONG
  );

Параметры

[in] unnamedParam1

Дескриптор, возвращаемый в элементе BusContext структуры USB_BUS_INTERFACE_USBDI_V0 запросом IRP_MN_QUERY_INTERFACE.

[out, optional] unnamedParam2

Указывает длину выходных данных.

[in, out] unnamedParam3

Указатель на буфер, который получает запрошенные сведения о шине.

[out] unnamedParam4

На входных данных — длина буфера, указанная параметром BusInformationBuffer. На выходе — длина выходных данных.

[in] unnamedParam5

Указывает уровень возвращаемой информации. Если значение Level равно 0, функция возвращает общую пропускную способность и общую используемую пропускную способность в битах в секунду. Если уровень равен 1, функция возвращает символьное имя контроллера в Юникоде в дополнение к общей пропускной способности и общей потребляемой пропускной способности.

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

QueryBusInformation возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Вызов успешно завершен.
STATUS_BUFFER_TOO_SMALL Буфер был слишком мал. Этот код ошибки возвращается в двух случаях:

Когда уровень == 0, этот код ошибки возвращается, если размер буфера, на который указывает BusInformationBuffer , меньше размера USB_BUS_INFORMATION_LEVEL_0 структуры.

Каждый раз, когда level == 1, этот код ошибки возвращается, если размер буфера, на который указывает BusInformationBuffer , меньше размера USB_BUS_INFORMATION_LEVEL_1 структуры.

Комментарии

Точные сведения, возвращаемые этой подпрограммой, зависят от значения параметра Level . Эта подпрограмма заменяет функцию библиотеки USBD_QueryBusInformation , предоставляемую usbd.sys.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть usbbusif.h (включая Usbbusif.h)
IRQL < = DISPATCH_LEVEL

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