EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

A função GetDeviceInfo retorna informações específicas do dispositivo com base no identificador fornecido

Especificar EfiUsbDeviceInfoUnknown como Id é tratado como um parâmetro inválido.

Sintaxe

typedef
EFI_STATUS
(EFIAPI * EFI_USBFN_IO_GET_DEVICE_INFO) (
  IN EFI_USBFN_IO_PROTOCOL      *This,
  IN EFI_USBFN_DEVICE_INFO_ID   Id,
  IN OUT UINTN                  *BufferSize,
  OUT VOID                      *Buffer OPTIONAL
  );

Parâmetros

Este
Um ponteiro para a instância EFI_USBFN_IO_PROTOCOL.

Id
Uma enumeração EFI_USBFN_DEVICE_INFO_ID que contém a ID do dispositivo solicitada.

BufferSize
Na entrada, o tamanho do Buffer em bytes. Na saída, a quantidade de dados retornados em Buffer em bytes.

Buffer
Um ponteiro para um buffer no qual as informações solicitadas serão retornadas como uma cadeia de caracteres Unicode.

Valores retornados

Essa função retorna os seguintes valores:

Código de retorno	Descrição
EFI_SUCCESS	A função foi retornada com êxito.
EFI_INVALID_PARAMETER	Um parâmetro é inválido.
EFI_DEVICE_ERROR	O dispositivo físico relatou um erro.
EFI_NOT_READY	O dispositivo físico está ocupado ou não está pronto para processar essa solicitação.
EFI_BUFFER_TOO_SMALL	O buffer fornecido não é grande o suficiente para manter a cadeia de caracteres de solicitação.

Comentários

Se o Buffer fornecido for muito pequeno ou NULL, o método falhará com EFI_BUFFER_TOO_SMALL e o tamanho necessário será retornado por meio de BufferSize. Todas as cadeias de caracteres retornadas estão no formato Unicode.

Requisitos

Cabeçalho: Usuário gerado