EFI_USBFN_IO_PROTOCOL. GetDeviceInfo

Artikel
06/15/2023

Die GetDeviceInfo-Funktion Gibt gerätespezifische Informationen basierend auf dem angegebenen Bezeichner zurück.

Die Angabe von EfiUsbDeviceInfoUnknown als ID wird als ungültiger Parameter behandelt.

Syntax

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

Parameter

Dieser
Ein Zeiger auf die EFI_USBFN_IO_PROTOCOL instance.

Id
Eine EFI_USBFN_DEVICE_INFO_ID-Enumeration , die die angeforderte Geräte-ID enthält.

BufferSize
Bei der Eingabe die Größe des Puffers in Bytes. Bei der Ausgabe die Im Puffer zurückgegebene Datenmenge in Byte.

Buffer
Ein Zeiger auf einen Puffer, in dem die angeforderten Informationen als Unicode-Zeichenfolge zurückgegeben werden.

Rückgabewerte

Diese Funktion gibt die folgenden Werte zurück:

Rückgabecode	Beschreibung
EFI_SUCCESS	Die Funktion wurde erfolgreich zurückgegeben.
EFI_INVALID_PARAMETER	Ein Parameter ist ungültig.
EFI_DEVICE_ERROR	Das physische Gerät hat einen Fehler gemeldet.
EFI_NOT_READY	Das physische Gerät ist ausgelastet oder nicht bereit, diese Anforderung zu verarbeiten.
EFI_BUFFER_TOO_SMALL	Der bereitgestellte Puffer ist nicht groß genug, um die Anforderungszeichenfolge zu enthalten.

Bemerkungen

Wenn der angegebene Puffer zu klein oder NULL ist, schlägt die Methode mit EFI_BUFFER_TOO_SMALL fehl, und die erforderliche Größe wird über BufferSize zurückgegeben. Alle zurückgegebenen Zeichenfolgen haben das Unicode-Format.

Anforderungen

Header: Vom Benutzer generiert

Freigeben über