Benutzerhandbuch für Intel Extensible Firmware Interface

Inhaltsverzeichnis

• Extensible Firmware Interface Specification

  1
• Disclaimer

  2
• Revision History

  3
• Table of Contents

  5
• 1 Introduction

  19
  • 1.1 Overview

    20
  • 1.2 Goals

    21
  • 1.3 Target Audience

    23
  • 1.4 Related Information

    24
  • 1.5 Prerequisite Specifications

    26
    • 1.5.1 ACPI Specification

      26
    • 1.5.2 WfM Specification

      26
    • 1.5.3 Additional Considerations for Intel® Itanium™-based Platforms

      27
  • 1.6 EFI Design Overview

    27
  • 1.7 Migration Requirements

    29
    • 1.7.1 Legacy Operating System Support

      29
    • 1.7.2 Supporting the EFI Specification on a Legacy Platform

      29
  • 1.8 Conventions Used in This Document

    30
    • 1.8.1 Data Structure Descriptions

      30
    • 1.8.2 Typographic Conventions

      30
  • 1.9 Guidelines for Use of the Term ”Extensible Firmware Interface”

    30
• 2 Overview

  31
  • 2.1 Boot Manager

    32
  • 2.2 Firmware Core

    32
    • 2.2.1 EFI Services

      32
    • 2.2.2 Runtime Services

      33
  • 2.3 Calling Conventions

    34
    • 2.3.1 Data Types

      34
    • 2.3.2 IA-32 Platforms

      36
    • 2.3.3 Itanium-based Platforms

      36
  • 2.4 Protocols

    37
  • 2.5 Requirements

    39
    • 2.5.1 Required Elements

      39
    • 2.5.2 Optional Elements

      40
    • 2.5.3 Appendixes

      41
• 3 Services

  43
  • 3.1 Event, Timer, and Task Priority Services

    44
    • 3.1.1 CreateEvent()

      47
    • 3.1.2 CloseEvent()

      51
    • 3.1.3 SignalEvent()

      52
    • 3.1.4 WaitForEvent()

      53
    • 3.1.5 CheckEvent()

      54
    • 3.1.6 SetTimer()

      55
    • 3.1.7 RaiseTPL()

      57
    • 3.1.8 RestoreTPL()

      59
  • 3.2 Memory Allocation Services

    60
    • 3.2.1 AllocatePages()

      63
    • 3.2.2 FreePages()

      66
    • 3.2.3 GetMemoryMap()

      67
    • 3.2.4 AllocatePool()

      71
    • 3.2.5 FreePool()

      72
  • 3.3 Protocol Handler Services

    73
    • 3.3.1 InstallProtocolInterface()

      75
    • 3.3.2 UninstallProtocolInterface()

      77
    • 3.3.3 ReinstallProtocolInterface()

      78
    • 3.3.4 RegisterProtocolNotify()

      79
    • 3.3.5 LocateHandle()

      80
    • 3.3.6 HandleProtocol()

      82
    • 3.3.7 LocateDevicePath()

      83
  • 3.4 Image Services

    85
    • 3.4.1 LoadImage()

      87
    • 3.4.2 StartImage()

      89
    • 3.4.3 UnloadImage()

      90
    • 3.4.4 EFI_IMAGE_ENTRY_POINT

      91
    • 3.4.5 Exit()

      92
    • 3.4.6 ExitBootServices()

      94
  • 3.5 Variable Services

    95
    • 3.5.1 GetVariable()

      96
    • 3.5.2 GetNextVariableName()

      98
    • 3.5.3 SetVariable()

      100
  • 3.6 Time Services

    102
    • 3.6.1 GetTime()

      103
    • 3.6.2 SetTime()

      106
    • 3.6.3 GetWakeupTime()

      107
    • 3.6.4 SetWakeupTime()

      108
  • 3.7 Virtual Memory Services

    109
    • 3.7.1 SetVirtualAddressMap()

      110
    • 3.7.2 ConvertPointer()

      112
  • 3.8 Miscellaneous Services

    113
    • 3.8.1 ResetSystem()

      114
    • 3.8.2 SetWatchdogTimer()

      116
    • 3.8.3 Stall()

      118
    • 3.8.4 GetNextMonotonicCount()

      119
    • 3.8.5 GetNextHighMonotonicCount()

      120
    • 3.8.6 InstallConfigurationTable()

      121
• 4 EFI Image

  123
  • 4.1 LOADED_IMAGE Protocol

    123
    • 4.1.1 LOADED_IMAGE.Unload()

      126
  • 4.2 EFI Image Header

    127
  • 4.3 EFI Applications

    128
  • 4.4 EFI OS Loaders

    128
  • 4.5 EFI Drivers

    128
    • 4.5.1 EFI Image Handoff State

      129
• 5 Device Path Protocol

  135
  • 5.1 Device Path Overview

    135
  • 5.2 EFI_DEVICE_PATH Protocol

    136
  • 5.3 Device Path Nodes

    137
    • 5.3.1 Generic Device Path Structures

      137
    • 5.3.2 Hardware Device Path

      138
    • 5.3.3 ACPI Device Path

      141
    • 5.3.4 Messaging Device Path

      141
    • 5.3.5 Media Device Path

      147
    • 5.3.6 BIOS Boot Specification Device Path

      151
  • 5.4 Device Path Generation Rules

    151
    • 5.4.1 Housekeeping Rules

      151
    • 5.4.2 Rules with ACPI _HID and _UID

      152
    • 5.4.3 Rules with ACPI _ADR

      153
    • 5.4.4 Hardware vs. Messaging Device Path Rules

      153
    • 5.4.5 Media Device Path Rules

      154
    • 5.4.6 Other Rules

      154
• 6 Device I/O Protocol

  155
  • 6.1 Device I/O Overview

    155
  • 6.2 DEVICE_IO Protocol

    156
    • 6.2.1 DEVICE_IO.Mem(), .Io(), and .Pci()

      159
    • 6.2.2 DEVICE_IO.PciDevicePath()

      161
    • 6.2.3 DEVICE_IO.Map()

      162
    • 6.2.4 DEVICE_IO.Unmap()

      164
    • 6.2.5 DEVICE_IO.AllocateBuffer()

      165
    • 6.2.6 DEVICE_IO.Flush()

      167
    • 6.2.7 DEVICE_IO.FreeBuffer()

      168
• 7 Console I/O Protocol

  169
  • 7.1 Console I/O Overview

    169
  • 7.2 ConsoleIn Definition

    170
  • 7.3 SIMPLE_INPUT Protocol

    172
    • 7.3.1 SIMPLE_INPUT.Reset()

      173
    • 7.3.2 SIMPLE_INPUT.ReadKeyStroke

      174
  • 7.4 ConsoleOut or StandardError

    175
  • 7.5 SIMPLE_TEXT_OUTPUT Protocol

    175
    • 7.5.1 SIMPLE_TEXT_OUTPUT.Reset()

      178
    • 7.5.2 SIMPLE_TEXT_OUTPUT.OutputString()

      179
    • 7.5.3 SIMPLE_TEXT_OUTPUT.TestString()

      182
    • 7.5.4 SIMPLE_TEXT_OUTPUT.QueryMode()

      183
    • 7.5.5 SIMPLE_TEXT_OUTPUT.SetMode()

      184
    • 7.5.6 SIMPLE_TEXT_OUTPUT.SetAttribute()

      185
    • 7.5.7 SIMPLE_TEXT_OUTPUT.ClearScreen()

      187
    • 7.5.8 SIMPLE_TEXT_OUTPUT.SetCursorPosition()

      188
    • 7.5.9 SIMPLE_TEXT_OUTPUT.EnableCursor()

      189
• 8 Block I/O Protocol

  191
  • 8.1 BLOCK_IO Protocol

    191
    • 8.1.1 EFI_BLOCK_IO.Reset()

      194
    • 8.1.2 EFI_BLOCK_IO.ReadBlocks()

      195
    • 8.1.3 EFI_BLOCK_IO.WriteBlocks()

      197
    • 8.1.4 BLOCK_IO.FlushBlocks()

      199
• 9 Disk I/O Protocol

  201
  • 9.1 DISK_IO Protocol

    201
    • 9.1.1 EFI_DISK_IO.ReadDisk()

      203
    • 9.1.2 EFI_DISK_IO.WriteDisk()

      204
• 10 File System Protocol

  205
  • 10.1 Simple File System Protocol

    205
    • 10.1.1 EFI_FILE_IO_INTERFACE.OpenVolume()

      207
  • 10.2 EFI_FILE Protocol

    208
    • 10.2.1 EFI_FILE.Open()

      210
    • 10.2.2 EFI_FILE.Close()

      213
    • 10.2.3 EFI_FILE.Delete()

      214
    • 10.2.4 EFI_FILE.Read()

      215
    • 10.2.5 EFI_FILE.Write()

      216
    • 10.2.6 EFI_FILE.SetPosition()

      217
    • 10.2.7 EFI_FILE.GetPosition()

      218
    • 10.2.8 EFI_FILE.GetInfo()

      219
    • 10.2.9 EFI_FILE.SetInfo()

      220
    • 10.2.10 EFI_FILE.Flush()

      221
    • 10.2.11 EFI_FILE_INFO

      222
    • 10.2.12 EFI_FILE_SYSTEM_INFO

      224
    • 10.2.13 EFI_FILE_SYSTEM_VOLUME_LABEL

      225
• 11 Load File Protocol

  227
  • 11.1 LOAD_FILE Protocol

    227
    • 11.1.1 LOAD_FILE.LoadFile()

      228
• 12 Serial I/O Protocol

  231
  • 12.1 SERIAL_IO Protocol

    231
    • 12.1.1 SERIAL_IO.Reset()

      235
    • 12.1.2 SERIAL_IO.SetAttributes()

      236
    • 12.1.3 SERIAL_IO.SetControl()

      238
    • 12.1.4 SERIAL_IO.GetControl()

      240
    • 12.1.5 SERIAL_IO.Write()

      241
    • 12.1.6 SERIAL_IO.Read()

      242
• 13 Unicode Collation Protocol

  243
  • 13.1 UNICODE_COLLATION Protocol

    243
    • 13.1.1 UNICODE_COLLATION.StriColl()

      245
    • 13.1.2 UNICODE_COLLATION.MetaiMatch()

      246
    • 13.1.3 UNICODE_COLLATION.StrLwr()

      248
    • 13.1.4 UNICODE_COLLATION.StrUpr()

      249
    • 13.1.5 UNICODE_COLLATION.FatToStr()

      250
    • 13.1.6 UNICODE_COLLATION.StrToFat()

      251
• 14 PXE Base Code Protocol

  253
  • 14.1 EFI_PXE_BASE_CODE Protocol

    253
    • 14.1.1 EFI_PXE_BASE_CODE.Start()

      265
    • 14.1.2 EFI_PXE_BASE_CODE.Stop()

      268
    • 14.1.3 EFI_PXE_BASE_CODE.Dhcp()

      269
    • 14.1.4 EFI_PXE_BASE_CODE.Discover()

      271
    • 14.1.5 EFI_PXE_BASE_CODE.Mtftp()

      275
    • 14.1.6 EFI_PXE_BASE_CODE.UdpWrite()

      279
    • 14.1.7 EFI_PXE_BASE_CODE.UdpRead()

      281
    • 14.1.8 EFI_PXE_BASE_CODE.SetIpFilter()

      284
    • 14.1.9 EFI_PXE_BASE_CODE.Arp()

      285
    • 14.1.10 EFI_PXE_BASE_CODE.SetParameters()

      286
    • 14.1.11 EFI_PXE_BASE_CODE.SetStationIp()

      288
    • 14.1.12 EFI_PXE_BASE_CODE.SetPackets()

      289
  • 14.2 EFI_PXE_BASE_CODE_CALLBACK Protocol

    291
    • 14.2.1 EFI_PXE_BASE_CODE_CALLBACK.Callback()

      292
• 15 Simple Network Protocol

  295
  • 15.1 EFI_SIMPLE_NETWORK Protocol

    295
    • 15.1.1 EFI_SIMPLE_NETWORK.Start()

      300
    • 15.1.2 EFI_SIMPLE_NETWORK.Stop()

      301
    • 15.1.3 EFI_SIMPLE_NETWORK.Initialize()

      302
    • 15.1.4 EFI_SIMPLE_NETWORK.Reset()

      303
    • 15.1.5 EFI_SIMPLE_NETWORK.Shutdown()

      304
    • 15.1.6 EFI_SIMPLE_NETWORK.ReceiveFilters()

      305
    • 15.1.7 EFI_SIMPLE_NETWORK.StationAddress()

      307
    • 15.1.8 EFI_SIMPLE_NETWORK.Statistics()

      308
    • 15.1.9 EFI_SIMPLE_NETWORK.MCastIPtoMAC()

      311
    • 15.1.10 EFI_SIMPLE_NETWORK.NvData()

      312
    • 15.1.11 EFI_SIMPLE_NETWORK.GetStatus()

      314
    • 15.1.12 EFI_SIMPLE_NETWORK.Transmit()

      316
    • 15.1.13 EFI_SIMPLE_NETWORK.Receive()

      318
  • 15.2 NETWORK_INTERFACE_IDENTIFIER Protocol

    320
• 16 File System Format

  323
  • 16.1 System Partition

    323
    • 16.1.1 File System Format

      324
    • 16.1.2 File Names

      324
    • 16.1.3 Directory Structure

      324
  • 16.2 Partition Discovery

    326
    • 16.2.1 EFI Partition Header

      327
    • 16.2.2 ISO-9660 and El Torito

      332
    • 16.2.3 Legacy Master Boot Record

      332
    • 16.2.4 Legacy Master Boot Record and GPT Partitions

      334
  • 16.3 Media Formats

    335
    • 16.3.1 Removable Media

      335
    • 16.3.2 Diskette

      335
    • 16.3.3 Hard Drive

      335
    • 16.3.4 CD-ROM and DVD-ROM

      336
    • 16.3.5 Network

      336
• 17 Boot Manager

  337
  • 17.1 Firmware Boot Manager

    337
  • 17.2 Globally-Defined Variables

    341
  • 17.3 Boot Option Variables Default Behavior

    343
  • 17.4 Boot Mechanisms

    343
    • 17.4.1 Boot via Simple File Protocol

      343
    • 17.4.2 Boot via LOAD_FILE Protocol

      344
• 18 PCI Expansion ROM

  345
  • 18.1 Standard PCI Expansion ROM Header

    345
  • 18.2 EFI PCI Expansion ROM Header

    346
  • 18.3 Multiple Image Format Support

    347
  • 18.4 EFI PCI Expansion ROM Driver

    347
• A GUID and Time Formats

  349
• B Console

  351
  • B.1 SIMPLE_INPUT

    351
  • B.2 SIMPLE_TEXT_OUTPUT

    352
• C Device Path Examples

  355
  • C.1 Example Computer System

    355
  • C.2 Legacy Floppy

    356
  • C.3 IDE Disk

    357
  • C.4 Secondary Root PCI Bus with PCI to PCI Bridge

    359
  • C.5 ACPI Terms

    360
  • C.6 EFI Device Path as a Name Space

    361
• D Status Codes

  363
• E Alphabetic Function Lists

  365
• F Glossary

  377
• G 32/64-Bit UNDI Specification

  391
  • G.1 Introduction

    391
    • G.1.1 Definitions

      391
    • G.1.2 Referenced Specifications

      392
    • G.1.3 OS Network Stacks

      394
  • G.2 Overview

    396
    • G.2.1 32/64-bit UNDI Interface

      396
    • G.2.2 UNDI Command Format

      402
  • G.3 UNDI C Definitions

    404
    • G.3.1 Portability Macros

      404
    • G.3.2 Miscellaneous Macros

      408
    • G.3.3 Portability Types

      408
    • G.3.4 Simple Types

      410
    • G.3.5 Compound Types

      427
  • G.4 UNDI Commands

    434
    • G.4.1 Command Linking & Queuing

      435
    • G.4.2 Get State

      436
    • G.4.3 Start

      438
    • G.4.4 Stop

      440
    • G.4.5 Get Init Info

      441
    • G.4.6 Get Config Info

      445
    • G.4.7 Initialize

      448
    • G.4.8 Reset

      452
    • G.4.9 Shutdown

      453
    • G.4.10 Interrupt Enables

      455
    • G.4.11 Receive Filters

      457
    • G.4.12 Station Address

      460
    • G.4.13 Statistics

      462
    • G.4.14 MCast IP To MAC

      466
    • G.4.15 NvData

      467
    • G.4.16 Get Status

      472
    • G.4.17 Fill Header

      474
    • G.4.18 Transmit

      478
    • G.4.19 Receive

      482
  • G.5 UNDI as an EFI Runtime Driver

    484
• H Index

  487