Read 関数は、デバイスからデータを読み取ります。
構文
typedef
EFI_STATUS
(EFIAPI * EFI_SIMPLE_WINPHONE_IO_READ) (
IN EFI_SIMPLE_WINPHONE_IO_PROTOCOL *This,
IN UINTN NumberOfBytesToRead,
IN OUT UINTN *NumberOfBytesRead,
OUT VOID *Buffer
);
パラメーター
This
EFI_SIMPLE_WINPHONE_IO_PROTOCOL インスタンスへのポインター。
NumberOfBytesToRead
読み取ることができる最大バイト数。
NumberOfBytesRead
バッファーで返されるデータ量 (バイト単位)。
Buffer
データを返すバッファー。
戻り値
この関数は、次のいずれかの値を返します。
状態コード | 説明 |
---|---|
EFI_SUCCESS | 関数が正常に返されました。 |
EFI_INVALID_PARAMETER | パラメーターが無効です。 |
EFI_DEVICE_ERROR | 物理デバイスからエラーが報告されました。 |
EFI_NOT_READY | 物理デバイスがビジー状態であるか、この要求を処理する準備ができていません。 |
EFI_TIMEOUT | 接続を確立する前にタイムアウトが発生しました。 |
EFI_NO_RESPONSE | ホストへの接続が存在しないか、終了しています。 |
解説
この関数は、要求された量のデータが使用可能になるまで、またはタイムアウトするまでブロックされます。
エラーが発生した場合、バイトは読み取られなくなり、該当する状態コードが返されます。 いずれの場合も、実際に読み取られたバイト数は NumberOfBytesRead で返されます。
要件
ヘッダー: ユーザー生成