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
);
パラメーター
This
EFI_USBFN_IO_PROTOCOL インスタンスへのポインタ。
Id
要求されたデバイス 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 | 指定されたバッファーは、要求文字列を保持する十分な大きさではありません。 |
解説
指定されたバッファーが小さすぎるか、または NULL の場合、メソッドは EFI_BUFFER_TOO_SMALL で失敗し、必要なサイズが BufferSize を介して返されます。 返されるすべての文字列は Unicode 形式です。
要件
ヘッダー: ユーザー生成