Compartilhar via

PUSB_BUSIFFN_QUERY_BUS_INFORMATION função de retorno de chamada (usbbusif.h)

  • Artigo

A rotina QueryBusInformation obtém informações sobre o barramento.

Sintaxe

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 retornado no membro BusContext da estrutura USB_BUS_INTERFACE_USBDI_V0 por uma solicitação de IRP_MN_QUERY_INTERFACE.

[out, optional] unnamedParam2

Especifica o comprimento dos dados de saída.

[in, out] unnamedParam3

Ponteiro para um buffer que recebe as informações de barramento solicitadas.

[out] unnamedParam4

Na entrada, o comprimento do buffer especificado por BusInformationBuffer. Na saída, o comprimento dos dados de saída.

[in] unnamedParam5

Especifica o nível de informações a serem retornadas. Se Level for 0, a função retornará a largura de banda total e a largura de banda total consumida em bits por segundo. Se Level for 1, a função retornará o nome simbólico do controlador em Unicode, além da largura de banda total e da largura de banda total consumida.

Retornar valor

QueryBusInformation retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS Chamada concluída com êxito.
STATUS_BUFFER_TOO_SMALL O buffer era muito pequeno. Esse código de erro é retornado em dois casos:

Sempre que Level == 0, esse código de erro é retornado se o tamanho do buffer apontado por BusInformationBuffer for menor que o tamanho da estrutura USB_BUS_INFORMATION_LEVEL_0 .

Sempre que Level == 1, esse código de erro será retornado se o tamanho do buffer apontado por BusInformationBuffer for menor que o tamanho da estrutura USB_BUS_INFORMATION_LEVEL_1 .

Comentários

As informações exatas retornadas por essa rotina dependem do valor do parâmetro Level . Essa rotina substitui a função de biblioteca de USBD_QueryBusInformation fornecida pelo usbd.sys.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho usbbusif.h (inclua Usbbusif.h)
IRQL < = DISPATCH_LEVEL

Confira também