EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

Articolo
06/15/2023

La funzione GetDeviceInfo restituisce informazioni specifiche del dispositivo in base all'identificatore fornito

Specificando EfiUsbDeviceInfoUnknown come ID viene considerato come parametro non valido.

Sintassi

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
  );

Parametri

This
Puntatore all'istanza di EFI_USBFN_IO_PROTOCOL.

Id
Enumerazione EFI_USBFN_DEVICE_INFO_ID contenente l'ID dispositivo richiesto.

BufferSize
In input, le dimensioni del buffer in byte. Nell'output la quantità di dati restituiti in buffer in byte.

Buffer
Puntatore a un buffer in cui le informazioni richieste verranno restituite come stringa Unicode.

Valori restituiti

Questa funzione restituisce i valori seguenti:

Codice restituito	Descrizione
EFI_SUCCESS	Funzione restituita correttamente.
EFI_INVALID_PARAMETER	Un parametro non è valido.
EFI_DEVICE_ERROR	Il dispositivo fisico ha segnalato un errore.
EFI_NOT_READY	Il dispositivo fisico è occupato o non è pronto per elaborare questa richiesta.
EFI_BUFFER_TOO_SMALL	Il buffer fornito non è sufficientemente grande da contenere la stringa della richiesta.

Commenti

Se il buffer fornito è troppo piccolo o NULL, il metodo ha esito negativo con EFI_BUFFER_TOO_SMALL e le dimensioni necessarie vengono restituite tramite BufferSize. Tutte le stringhe restituite sono in formato Unicode.

Requisiti

Intestazione: Utente generato

Condividi tramite