EFI_INVALID_PARAMETERとは？
BIOS/UEFIおよびembedded firmware学習者向けにEFI_INVALID_PARAMETERを説明するクイックノート。
EFI_INVALID_PARAMETERは、return status、log、command、failure pointを理解するためのfirmware debugging概念である。
なぜ重要か
- UEFIのreturn valueを理解しやすくする。
- driver/applicationで安全なerror handlingを書く助けになる。
- debug log内のservice call failureを追うときに役立つ。
実例
例：UEFI APIがerrorを返した後はoutput parameterを使わない。まずEFI_STATUSを確認し、retry、buffer再確保、clean failureのどれにするかを決める。
クイックチェックリスト
覚えておくポイント
EFI_INVALID_PARAMETERは小さな概念に見えても、logを読むときや実際のfirmware debugで重要になる。
システムの流れに置く
EFI_INVALID_PARAMETER は、単独の用語として暗記するよりも、firmware の流れの中に置くと理解しやすいです。誰が作り、誰が読み、値が間違ったときにどの症状として出るのかを意識すると、学習用のメモがそのまま debug のチェックポイントになります。
イメージしやすい例
実際の debug では、log が多いことよりも、どこまで正しいと確認できたかが重要です。EFI_INVALID_PARAMETER に関係する log や shell output を見るときは、最後に確実に正しい地点を決めてから、次の境界へ進むようにしています。
実際のデバッグで見るポイント
EFI_INVALID_PARAMETER は、log 上の checkpoint として使うと役に立ちます。「意味は何か」だけでなく、「どの条件で発生するか」「どの module が返すか」「その後 retry するのか、fallback するのか、停止するのか」を確認します。
Firmware debug では、量の多い log よりも、境界に置いた短い log の方が強いことがあります。API 呼び出し前の state、input、return status、その後の分岐を残すと追いやすくなります。
関連ノート
- UEFI Driver ModelにおけるSupported()とは？
- UEFI Driver ModelにおけるStart()とは？
- UEFI Driver ModelにおけるStop()とは？
- UEFI Device Driverとは？
- EFI_UNSUPPORTEDとは？
公開参考資料
この記事は役に立ちましたか？
ファームウェア、BIOS/UEFI、組み込みシステムを学んでいる人に共有できます。
Biến note thành bài viết hoàn chỉnh
Notes là nơi ghi nhanh khái niệm.