Partager via


EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

La fonction GetDeviceInfo renvoie des informations spécifiques à l’appareil en fonction de l’identificateur fourni.

La spécification d’EfiUsbDeviceInfoUnknown en tant que ID est traitée comme un paramètre non valide.

Syntaxe

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

Paramètres

Ce
Pointeur vers le EFI_USBFN_IO_PROTOCOL instance.

Id
Énumération EFI_USBFN_DEVICE_INFO_ID qui contient l’ID d’appareil demandé.

BufferSize
Lors de l’entrée, la taille de la mémoire tampon en octets. En sortie, la quantité de données retournées dans La mémoire tampon en octets.

Buffer
Pointeur vers une mémoire tampon dans laquelle les informations demandées seront retournées sous la forme d’une chaîne Unicode.

Valeurs retournées

Cette fonction retourne les valeurs suivantes :

Code de retour Description
EFI_SUCCESS La fonction a bien retourné la valeur attendue.
EFI_INVALID_PARAMETER Un paramètre n'est pas valide.
EFI_DEVICE_ERROR L’appareil physique a signalé une erreur.
EFI_NOT_READY L’appareil physique est occupé ou n’est pas prêt à traiter cette demande.
EFI_BUFFER_TOO_SMALL La mémoire tampon fournie n’est pas assez grande pour contenir la chaîne de requête.

Notes

Si la mémoire tampon fournie est trop petite ou NULL, la méthode échoue avec EFI_BUFFER_TOO_SMALL et la taille requise est retournée via BufferSize. Toutes les chaînes retournées sont au format Unicode.

Spécifications

En-tête: Généré par l’utilisateur