UEFI原理与编程（六）：UEFI工程模块文件-驱动模块工程文件

UEFI工程模块文件-驱动模块

前言

　　在UEFI中，驱动分为两类：一类是符合UEFI的驱动模型的驱动，模型的类型为UEFI_DRIVER，称为UEFI驱动；另一类是不遵循UEFI驱动模型的驱动，称为DXE驱动。下面介绍的是UEFI驱动工程文件格式。

一、驱动与应用程序

　　1. 驱动与应用程序的入口函数相同，入口函数原型如下：

typedef EFI_STATUS API (*UEFI_ENTRYPOINT)(
    IN EFI_HANDLE ImageHandle,
    IN EFI_SYSTEM_TABLE *SystemTable
)

　　2. 驱动与应用程序的最大区别是驱动会常驻内存，而应用程序执行完毕后就会从内存清除。

二、UEFI驱动模块工程文件

　　基本和应用程序模块相同，注意一下几点即可。

• [Defines]块
  将MODULE_TYPE设置为UEFI_DRIVER
• [Sources]块
  通常包含ComponentName.c，在此文件中定义了驱动的名字，驱动安装之后，这个名字将显示给用户。
• [LibraryClasses]块
  必须包含UefiDriverEntryPoint。

三、UEFI驱动模块工程文件示例

## @file
#  Module that lays Disk I/O protocol on every Block I/O protocol.
#
#  This module produces Disk I/O protocol to abstract the block accesses
#  of the Block I/O protocol to a more general offset-length protocol
#  to provide byte-oriented access to block media. It adds this protocol
#  to any Block I/O interface that appears in the system that does not
#  already have a Disk I/O protocol. File systems and other disk access
#  code utilize the Disk I/O protocol.
#  
#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
#  This program and the accompanying materials
#  are licensed and made available under the terms and conditions of the BSD License
#  which accompanies this distribution.  The full text of the license may be found at
#  http://opensource.org/licenses/bsd-license.php
#  
#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#  
##

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = DiskIoDxe
  MODULE_UNI_FILE                = DiskIoDxe.uni
  FILE_GUID                      = 6B38F7B4-AD98-40e9-9093-ACA2B5A253C4
  MODULE_TYPE                    = UEFI_DRIVER
  VERSION_STRING                 = 1.0
  ENTRY_POINT                    = InitializeDiskIo

#
# The following information is for reference only and not required by the build tools.
#
#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
#
#  DRIVER_BINDING                =  gDiskIoDriverBinding
#  COMPONENT_NAME                =  gDiskIoComponentName
#  COMPONENT_NAME2               =  gDiskIoComponentName2
#

[Sources]
  ComponentName.c
  DiskIo.h
  DiskIo.c


[Packages]
  MdePkg/MdePkg.dec
  MdeModulePkg/MdeModulePkg.dec

[LibraryClasses]
  UefiBootServicesTableLib
  MemoryAllocationLib
  BaseMemoryLib
  BaseLib
  UefiLib
  UefiDriverEntryPoint
  DebugLib
  PcdLib

[Protocols]
  gEfiDiskIoProtocolGuid                        ## BY_START
  gEfiDiskIo2ProtocolGuid                       ## BY_START
  gEfiBlockIoProtocolGuid                       ## TO_START
  gEfiBlockIo2ProtocolGuid                      ## TO_START

[Pcd]
  gEfiMdeModulePkgTokenSpaceGuid.PcdDiskIoDataBufferBlockNum    ## SOMETIMES_CONSUMES

[UserExtensions.TianoCore."ExtraFiles"]
  DiskIoDxeExtra.uni

四、小结

　　本文只是简要介绍了驱动模块的工程文件。关于驱动模块的更详细知识内容，后续再边学边整理。你也可以去看《UEFI原理与编程》的第九章开发UEFI驱动学习。

参考资料

1. 《UEFI原理与编程》 戴正华 著。
2. 　UEFI Spec2_6。