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 bus.

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 de bus solicitada.

[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 Level 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 total consumido.

Valor devuelto

QueryBusInformation devuelve uno de los siguientes valores:

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

Siempre 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 USB_BUS_INFORMATION_LEVEL_0 .

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

Comentarios

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 Value
Plataforma de destino Escritorio
Encabezado usbbusif.h (incluye Usbbusif.h)
IRQL < = DISPATCH_LEVEL

Consulte también