共用方式為

EFI_USBFN_IO_PROTOCOL。GetDeviceInfo

  • 發行項

GetDeviceInfo函式會根據提供的識別碼傳回裝置特定資訊

將 EfiUsbDeviceInfoUnknown 指定為 Id 會被視為不正確參數。

語法

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

參數

這
EFI_USBFN_IO_PROTOCOL 實例的指標。

Id
包含所要求裝置識別碼 的EFI_USBFN_DEVICE_INFO_ID 列舉。

BufferSize
在輸入時，緩衝區的大小以位元組為單位。 輸出時，以位元組為單位以 Buffer 傳回的資料量。

Buffer
緩衝區的指標，其中要求的資訊會以 Unicode 字串的形式傳回。

傳回值

此函式會傳回下列值：

傳回碼 描述
EFI_SUCCESS 函式成功傳回。
EFI_INVALID_PARAMETER 有一個參數無效。
EFI_DEVICE_ERROR 實體裝置回報錯誤。
EFI_NOT_READY 實體裝置忙碌中或尚未準備好處理此要求。
EFI_BUFFER_TOO_SMALL 提供的緩衝區不夠大，無法保存要求字串。

備註

如果提供的 Buffer 太小或 Null，方法會因為 EFI_BUFFER_TOO_SMALL 而失敗，而且會透過 BufferSize傳回所需的大小。 所有傳回的字串都是 Unicode 格式。

規格需求

頭： 使用者產生的