Compartir a través de

PUSB_BUSIFFN_QUERY_BUS_INFORMATION función de devolución de llamada (usbbusif.h)

  • Artículo

La rutina QueryBusInformation obtiene información sobre el autobús.

Sintaxis

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

Parámetros

[in] unnamedParam1

Identificador devuelto en el miembro BusContext de la estructura USB_BUS_INTERFACE_USBDI_V0 mediante una solicitud de IRP_MN_QUERY_INTERFACE.

[out, optional] unnamedParam2

Especifica la longitud de los datos de salida.

[in, out] unnamedParam3

Puntero a un búfer que recibe la información solicitada del bus.

[out] unnamedParam4

En la entrada, la longitud del búfer especificado por BusInformationBuffer. En la salida, la longitud de los datos de salida.

[in] unnamedParam5

Especifica el nivel de información que se va a devolver. Si nivel es 0, la función devuelve el ancho de banda total y el ancho de banda consumido total en bits por segundo. Si Level es 1, la función devuelve el nombre simbólico del controlador en Unicode, además del ancho de banda total y el ancho de banda consumido total.

Valor devuelto

queryBusInformation devuelve uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS La llamada se completó correctamente.
STATUS_BUFFER_TOO_SMALL El búfer era demasiado pequeño. Este código de error se devuelve en dos casos:

Cada vez que Level == 0, este código de error se devuelve si el tamaño del búfer al que apunta busInformationBuffer es menor que el tamaño de la estructura de USB_BUS_INFORMATION_LEVEL_0.

Whenever Level == 1, este código de error se devuelve si el tamaño del búfer al que apunta BusInformationBuffer menor que el tamaño de la estructura de USB_BUS_INFORMATION_LEVEL_1.

Observaciones

La información exacta devuelta por esta rutina depende del valor del parámetro Level. Esta rutina reemplaza la función de biblioteca de USBD_QueryBusInformation proporcionada por usbd.sys.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de usbbusif.h (include Usbbusif.h)
irQL < = DISPATCH_LEVEL

Consulte también