Udf.h

Go to the documentation of this file.

 
#ifndef _UDF_H_
#define _UDF_H_
 
#include <Uefi.h>
#include <Base.h>
 
#include <Protocol/BlockIo.h>
#include <Protocol/ComponentName.h>
#include <Protocol/DevicePath.h>
#include <Protocol/DriverBinding.h>
#include <Protocol/DiskIo.h>
#include <Protocol/SimpleFileSystem.h>
 
#include <Guid/FileInfo.h>
#include <Guid/FileSystemInfo.h>
#include <Guid/FileSystemVolumeLabelInfo.h>
 
#include <Library/DebugLib.h>
#include <Library/UefiDriverEntryPoint.h>
#include <Library/BaseLib.h>
#include <Library/UefiLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/DevicePathLib.h>
 
#include <IndustryStandard/ElTorito.h>
#include <IndustryStandard/Udf.h>
 
//
// C5BD4D42-1A76-4996-8956-73CDA326CD0A
//
#define EFI_UDF_DEVICE_PATH_GUID                        \
  { 0xC5BD4D42, 0x1A76, 0x4996,                         \
    { 0x89, 0x56, 0x73, 0xCD, 0xA3, 0x26, 0xCD, 0x0A }  \
  }
 
#define FE_ICB_FILE_TYPE(_Ptr)                                      \
  (UDF_FILE_ENTRY_TYPE)(                                            \
    ((UDF_DESCRIPTOR_TAG *)(_Ptr))->TagIdentifier == UdfFileEntry ? \
    ((UDF_FILE_ENTRY *)(_Ptr))->IcbTag.FileType :                   \
    ((UDF_EXTENDED_FILE_ENTRY *)(_Ptr))->IcbTag.FileType)
 
typedef enum {
  UdfFileEntryDirectory    = 4,
  UdfFileEntryStandardFile = 5,
  UdfFileEntrySymlink      = 12,
} UDF_FILE_ENTRY_TYPE;
 
#define HIDDEN_FILE     (1 << 0)
#define DIRECTORY_FILE  (1 << 1)
#define DELETED_FILE    (1 << 2)
#define PARENT_FILE     (1 << 3)
 
#define IS_FID_HIDDEN_FILE(_Fid) \
  (BOOLEAN)((_Fid)->FileCharacteristics & HIDDEN_FILE)
#define IS_FID_DIRECTORY_FILE(_Fid) \
  (BOOLEAN)((_Fid)->FileCharacteristics & DIRECTORY_FILE)
#define IS_FID_DELETED_FILE(_Fid) \
  (BOOLEAN)((_Fid)->FileCharacteristics & DELETED_FILE)
#define IS_FID_PARENT_FILE(_Fid) \
  (BOOLEAN)((_Fid)->FileCharacteristics & PARENT_FILE)
#define IS_FID_NORMAL_FILE(_Fid) \
  (BOOLEAN)(!IS_FID_DIRECTORY_FILE (_Fid) && \
            !IS_FID_PARENT_FILE (_Fid))
 
typedef enum {
  ShortAdsSequence,
  LongAdsSequence,
  ExtendedAdsSequence,
  InlineData
} UDF_FE_RECORDING_FLAGS;
 
#define GET_FE_RECORDING_FLAGS(_Fe) \
  ((UDF_FE_RECORDING_FLAGS)((UDF_ICB_TAG *)( \
                  (UINT8 *)(_Fe) + \
                  sizeof (UDF_DESCRIPTOR_TAG)))->Flags & 0x07)
 
typedef enum {
  ExtentRecordedAndAllocated,
  ExtentNotRecordedButAllocated,
  ExtentNotRecordedNotAllocated,
  ExtentIsNextExtent,
} UDF_EXTENT_FLAGS;
 
#define AD_LENGTH(_RecFlags) \
  ((_RecFlags) == ShortAdsSequence ? \
   ((UINT64)(sizeof (UDF_SHORT_ALLOCATION_DESCRIPTOR))) : \
   ((UINT64)(sizeof (UDF_LONG_ALLOCATION_DESCRIPTOR))))
 
#define GET_EXTENT_FLAGS(_RecFlags, _Ad) \
  ((_RecFlags) == ShortAdsSequence ? \
   ((UDF_EXTENT_FLAGS)((((UDF_SHORT_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength >> \
            30) & 0x3)) : \
   ((UDF_EXTENT_FLAGS)((((UDF_LONG_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength >> \
            30) & 0x3)))
 
#define GET_EXTENT_LENGTH(_RecFlags, _Ad) \
  ((_RecFlags) == ShortAdsSequence ? \
   ((UINT32)((((UDF_SHORT_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength & \
          ~0xC0000000UL))) : \
   ((UINT32)((((UDF_LONG_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength & \
          ~0xC0000000UL))))
 
#define UDF_FILENAME_LENGTH  128
#define UDF_PATH_LENGTH      512
 
#define GET_FID_FROM_ADS(_Data, _Offs) \
  ((UDF_FILE_IDENTIFIER_DESCRIPTOR *)((UINT8 *)(_Data) + (_Offs)))
 
#define IS_VALID_COMPRESSION_ID(_CompId) \
  ((BOOLEAN)((_CompId) == 8 || (_CompId) == 16))
 
#define UDF_STANDARD_IDENTIFIER_LENGTH  5
 
#pragma pack(1)
 
typedef struct {
  UINT8    StandardIdentifier[UDF_STANDARD_IDENTIFIER_LENGTH];
} UDF_STANDARD_IDENTIFIER;
 
#pragma pack()
 
typedef enum {
  ReadFileGetFileSize,
  ReadFileAllocateAndRead,
  ReadFileSeekAndRead,
} UDF_READ_FILE_FLAGS;
 
typedef struct {
  VOID                   *FileData;
  UDF_READ_FILE_FLAGS    Flags;
  UINT64                 FileDataSize;
  UINT64                 FilePosition;
  UINT64                 FileSize;
  UINT64                 ReadLength;
} UDF_READ_FILE_INFO;
 
#pragma pack(1)
 
typedef struct {
  UINT16    TypeAndTimezone;
  INT16     Year;
  UINT8     Month;
  UINT8     Day;
  UINT8     Hour;
  UINT8     Minute;
  UINT8     Second;
  UINT8     Centiseconds;
  UINT8     HundredsOfMicroseconds;
  UINT8     Microseconds;
} UDF_TIMESTAMP;
 
typedef struct {
  UDF_DESCRIPTOR_TAG    DescriptorTag;
  UINT32                PrevAllocationExtentDescriptor;
  UINT32                LengthOfAllocationDescriptors;
} UDF_ALLOCATION_EXTENT_DESCRIPTOR;
 
typedef struct {
  UINT8    StructureType;
  UINT8    StandardIdentifier[UDF_STANDARD_IDENTIFIER_LENGTH];
  UINT8    StructureVersion;
  UINT8    Reserved;
  UINT8    StructureData[2040];
} UDF_VOLUME_DESCRIPTOR;
 
typedef struct {
  UDF_DESCRIPTOR_TAG    DescriptorTag;
  UDF_TIMESTAMP         RecordingDateTime;
  UINT32                IntegrityType;
  UDF_EXTENT_AD         NextIntegrityExtent;
  UINT8                 LogicalVolumeContentsUse[32];
  UINT32                NumberOfPartitions;
  UINT32                LengthOfImplementationUse;
  UINT8                 Data[0];
} UDF_LOGICAL_VOLUME_INTEGRITY;
 
typedef struct {
  UDF_DESCRIPTOR_TAG    DescriptorTag;
  UINT32                VolumeDescriptorSequenceNumber;
  UINT16                PartitionFlags;
  UINT16                PartitionNumber;
  UDF_ENTITY_ID         PartitionContents;
  UINT8                 PartitionContentsUse[128];
  UINT32                AccessType;
  UINT32                PartitionStartingLocation;
  UINT32                PartitionLength;
  UDF_ENTITY_ID         ImplementationIdentifier;
  UINT8                 ImplementationUse[128];
  UINT8                 Reserved[156];
} UDF_PARTITION_DESCRIPTOR;
 
typedef struct {
  UDF_DESCRIPTOR_TAG                DescriptorTag;
  UDF_TIMESTAMP                     RecordingDateAndTime;
  UINT16                            InterchangeLevel;
  UINT16                            MaximumInterchangeLevel;
  UINT32                            CharacterSetList;
  UINT32                            MaximumCharacterSetList;
  UINT32                            FileSetNumber;
  UINT32                            FileSetDescriptorNumber;
  UDF_CHAR_SPEC                     LogicalVolumeIdentifierCharacterSet;
  UINT8                             LogicalVolumeIdentifier[128];
  UDF_CHAR_SPEC                     FileSetCharacterSet;
  UINT8                             FileSetIdentifier[32];
  UINT8                             CopyrightFileIdentifier[32];
  UINT8                             AbstractFileIdentifier[32];
  UDF_LONG_ALLOCATION_DESCRIPTOR    RootDirectoryIcb;
  UDF_ENTITY_ID                     DomainIdentifier;
  UDF_LONG_ALLOCATION_DESCRIPTOR    NextExtent;
  UDF_LONG_ALLOCATION_DESCRIPTOR    SystemStreamDirectoryIcb;
  UINT8                             Reserved[32];
} UDF_FILE_SET_DESCRIPTOR;
 
typedef struct {
  UINT32    ExtentLength;
  UINT32    ExtentPosition;
} UDF_SHORT_ALLOCATION_DESCRIPTOR;
 
typedef struct {
  UDF_DESCRIPTOR_TAG                DescriptorTag;
  UINT16                            FileVersionNumber;
  UINT8                             FileCharacteristics;
  UINT8                             LengthOfFileIdentifier;
  UDF_LONG_ALLOCATION_DESCRIPTOR    Icb;
  UINT16                            LengthOfImplementationUse;
  UINT8                             Data[0];
} UDF_FILE_IDENTIFIER_DESCRIPTOR;
 
typedef struct {
  UINT32         PriorRecordNumberOfDirectEntries;
  UINT16         StrategyType;
  UINT16         StrategyParameter;
  UINT16         MaximumNumberOfEntries;
  UINT8          Reserved;
  UINT8          FileType;
  UDF_LB_ADDR    ParentIcbLocation;
  UINT16         Flags;
} UDF_ICB_TAG;
 
typedef struct {
  UDF_DESCRIPTOR_TAG                DescriptorTag;
  UDF_ICB_TAG                       IcbTag;
  UINT32                            Uid;
  UINT32                            Gid;
  UINT32                            Permissions;
  UINT16                            FileLinkCount;
  UINT8                             RecordFormat;
  UINT8                             RecordDisplayAttributes;
  UINT32                            RecordLength;
  UINT64                            InformationLength;
  UINT64                            LogicalBlocksRecorded;
  UDF_TIMESTAMP                     AccessTime;
  UDF_TIMESTAMP                     ModificationTime;
  UDF_TIMESTAMP                     AttributeTime;
  UINT32                            CheckPoint;
  UDF_LONG_ALLOCATION_DESCRIPTOR    ExtendedAttributeIcb;
  UDF_ENTITY_ID                     ImplementationIdentifier;
  UINT64                            UniqueId;
  UINT32                            LengthOfExtendedAttributes;
  UINT32                            LengthOfAllocationDescriptors;
  UINT8                             Data[0]; // L_EA + L_AD
} UDF_FILE_ENTRY;
 
typedef struct {
  UDF_DESCRIPTOR_TAG                DescriptorTag;
  UDF_ICB_TAG                       IcbTag;
  UINT32                            Uid;
  UINT32                            Gid;
  UINT32                            Permissions;
  UINT16                            FileLinkCount;
  UINT8                             RecordFormat;
  UINT8                             RecordDisplayAttributes;
  UINT32                            RecordLength;
  UINT64                            InformationLength;
  UINT64                            ObjectSize;
  UINT64                            LogicalBlocksRecorded;
  UDF_TIMESTAMP                     AccessTime;
  UDF_TIMESTAMP                     ModificationTime;
  UDF_TIMESTAMP                     CreationTime;
  UDF_TIMESTAMP                     AttributeTime;
  UINT32                            CheckPoint;
  UINT32                            Reserved;
  UDF_LONG_ALLOCATION_DESCRIPTOR    ExtendedAttributeIcb;
  UDF_LONG_ALLOCATION_DESCRIPTOR    StreamDirectoryIcb;
  UDF_ENTITY_ID                     ImplementationIdentifier;
  UINT64                            UniqueId;
  UINT32                            LengthOfExtendedAttributes;
  UINT32                            LengthOfAllocationDescriptors;
  UINT8                             Data[0]; // L_EA + L_AD
} UDF_EXTENDED_FILE_ENTRY;
 
typedef struct {
  UINT8     ComponentType;
  UINT8     LengthOfComponentIdentifier;
  UINT16    ComponentFileVersionNumber;
  UINT8     ComponentIdentifier[0];
} UDF_PATH_COMPONENT;
 
#pragma pack()
 
//
// UDF filesystem driver's private data
//
typedef struct {
  UINT64                           MainVdsStartLocation;
  UDF_LOGICAL_VOLUME_DESCRIPTOR    LogicalVolDesc;
  UDF_PARTITION_DESCRIPTOR         PartitionDesc;
  UDF_FILE_SET_DESCRIPTOR          FileSetDesc;
  UINTN                            FileEntrySize;
} UDF_VOLUME_INFO;
 
typedef struct {
  VOID                              *FileEntry;
  UDF_FILE_IDENTIFIER_DESCRIPTOR    *FileIdentifierDesc;
} UDF_FILE_INFO;
 
typedef struct {
  VOID      *DirectoryData;
  UINT64    DirectoryLength;
  UINT64    FidOffset;
} UDF_READ_DIRECTORY_INFO;
 
#define PRIVATE_UDF_FILE_DATA_SIGNATURE  SIGNATURE_32 ('U', 'd', 'f', 'f')
 
#define PRIVATE_UDF_FILE_DATA_FROM_THIS(a) \
  CR ( \
      a, \
      PRIVATE_UDF_FILE_DATA, \
      FileIo, \
      PRIVATE_UDF_FILE_DATA_SIGNATURE \
      )
 
typedef struct {
  UINTN                              Signature;
  BOOLEAN                            IsRootDirectory;
  UDF_FILE_INFO                      *Root;
  UDF_FILE_INFO                      File;
  UDF_READ_DIRECTORY_INFO            ReadDirInfo;
  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL    *SimpleFs;
  EFI_FILE_PROTOCOL                  FileIo;
  CHAR16                             AbsoluteFileName[UDF_PATH_LENGTH];
  CHAR16                             FileName[UDF_FILENAME_LENGTH];
  UINT64                             FileSize;
  UINT64                             FilePosition;
} PRIVATE_UDF_FILE_DATA;
 
#define PRIVATE_UDF_SIMPLE_FS_DATA_SIGNATURE  SIGNATURE_32 ('U', 'd', 'f', 's')
 
#define PRIVATE_UDF_SIMPLE_FS_DATA_FROM_THIS(a) \
  CR ( \
      a, \
      PRIVATE_UDF_SIMPLE_FS_DATA, \
      SimpleFs, \
      PRIVATE_UDF_SIMPLE_FS_DATA_SIGNATURE \
      )
 
typedef struct {
  UINTN                              Signature;
  EFI_BLOCK_IO_PROTOCOL              *BlockIo;
  EFI_DISK_IO_PROTOCOL               *DiskIo;
  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL    SimpleFs;
  UDF_VOLUME_INFO                    Volume;
  UDF_FILE_INFO                      Root;
  UINTN                              OpenFiles;
  EFI_HANDLE                         Handle;
} PRIVATE_UDF_SIMPLE_FS_DATA;
 
//
// Global Variables
//
extern EFI_DRIVER_BINDING_PROTOCOL   gUdfDriverBinding;
extern EFI_COMPONENT_NAME_PROTOCOL   gUdfComponentName;
extern EFI_COMPONENT_NAME2_PROTOCOL  gUdfComponentName2;
 
//
// Function Prototypes
//
 
EFI_STATUS
EFIAPI
UdfOpenVolume (
  IN   EFI_SIMPLE_FILE_SYSTEM_PROTOCOL  *This,
  OUT  EFI_FILE_PROTOCOL                **Root
  );
 
EFI_STATUS
EFIAPI
UdfOpen (
  IN   EFI_FILE_PROTOCOL  *This,
  OUT  EFI_FILE_PROTOCOL  **NewHandle,
  IN   CHAR16             *FileName,
  IN   UINT64             OpenMode,
  IN   UINT64             Attributes
  );
 
EFI_STATUS
EFIAPI
UdfRead (
  IN      EFI_FILE_PROTOCOL  *This,
  IN OUT  UINTN              *BufferSize,
  OUT     VOID               *Buffer
  );
 
EFI_STATUS
EFIAPI
UdfClose (
  IN EFI_FILE_PROTOCOL  *This
  );
 
EFI_STATUS
EFIAPI
UdfDelete (
  IN EFI_FILE_PROTOCOL  *This
  );
 
EFI_STATUS
EFIAPI
UdfWrite (
  IN      EFI_FILE_PROTOCOL  *This,
  IN OUT  UINTN              *BufferSize,
  IN      VOID               *Buffer
  );
 
EFI_STATUS
EFIAPI
UdfGetPosition (
  IN   EFI_FILE_PROTOCOL  *This,
  OUT  UINT64             *Position
  );
 
EFI_STATUS
EFIAPI
UdfSetPosition (
  IN EFI_FILE_PROTOCOL  *This,
  IN UINT64             Position
  );
 
EFI_STATUS
EFIAPI
UdfGetInfo (
  IN      EFI_FILE_PROTOCOL  *This,
  IN      EFI_GUID           *InformationType,
  IN OUT  UINTN              *BufferSize,
  OUT     VOID               *Buffer
  );
 
EFI_STATUS
EFIAPI
UdfSetInfo (
  IN EFI_FILE_PROTOCOL  *This,
  IN EFI_GUID           *InformationType,
  IN UINTN              BufferSize,
  IN VOID               *Buffer
  );
 
EFI_STATUS
EFIAPI
UdfFlush (
  IN EFI_FILE_PROTOCOL  *This
  );
 
EFI_STATUS
ReadUdfVolumeInformation (
  IN   EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL   *DiskIo,
  OUT  UDF_VOLUME_INFO        *Volume
  );
 
EFI_STATUS
FindRootDirectory (
  IN   EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL   *DiskIo,
  IN   UDF_VOLUME_INFO        *Volume,
  OUT  UDF_FILE_INFO          *File
  );
 
EFI_STATUS
FindFileEntry (
  IN   EFI_BLOCK_IO_PROTOCOL           *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL            *DiskIo,
  IN   UDF_VOLUME_INFO                 *Volume,
  IN   UDF_LONG_ALLOCATION_DESCRIPTOR  *Icb,
  OUT  VOID                            **FileEntry
  );
 
EFI_STATUS
FindFile (
  IN   EFI_BLOCK_IO_PROTOCOL           *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL            *DiskIo,
  IN   UDF_VOLUME_INFO                 *Volume,
  IN   CHAR16                          *FilePath,
  IN   UDF_FILE_INFO                   *Root,
  IN   UDF_FILE_INFO                   *Parent,
  IN   UDF_LONG_ALLOCATION_DESCRIPTOR  *Icb,
  OUT  UDF_FILE_INFO                   *File
  );
 
EFI_STATUS
ReadDirectoryEntry (
  IN      EFI_BLOCK_IO_PROTOCOL           *BlockIo,
  IN      EFI_DISK_IO_PROTOCOL            *DiskIo,
  IN      UDF_VOLUME_INFO                 *Volume,
  IN      UDF_LONG_ALLOCATION_DESCRIPTOR  *ParentIcb,
  IN      VOID                            *FileEntryData,
  IN OUT  UDF_READ_DIRECTORY_INFO         *ReadDirInfo,
  OUT     UDF_FILE_IDENTIFIER_DESCRIPTOR  **FoundFid
  );
 
EFI_STATUS
GetFileNameFromFid (
  IN   UDF_FILE_IDENTIFIER_DESCRIPTOR  *FileIdentifierDesc,
  IN   UINTN                           CharMax,
  OUT  CHAR16                          *FileName
  );
 
EFI_STATUS
ResolveSymlink (
  IN   EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL   *DiskIo,
  IN   UDF_VOLUME_INFO        *Volume,
  IN   UDF_FILE_INFO          *Parent,
  IN   VOID                   *FileEntryData,
  OUT  UDF_FILE_INFO          *File
  );
 
VOID
CleanupFileInformation (
  IN UDF_FILE_INFO  *File
  );
 
EFI_STATUS
GetFileSize (
  IN   EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL   *DiskIo,
  IN   UDF_VOLUME_INFO        *Volume,
  IN   UDF_FILE_INFO          *File,
  OUT  UINT64                 *Size
  );
 
EFI_STATUS
SetFileInfo (
  IN      UDF_FILE_INFO  *File,
  IN      UINT64         FileSize,
  IN      CHAR16         *FileName,
  IN OUT  UINTN          *BufferSize,
  OUT     VOID           *Buffer
  );
 
EFI_STATUS
GetVolumeLabel (
  IN   UDF_VOLUME_INFO  *Volume,
  IN   UINTN            CharMax,
  OUT  CHAR16           *String
  );
 
EFI_STATUS
GetVolumeSize (
  IN   EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN   EFI_DISK_IO_PROTOCOL   *DiskIo,
  IN   UDF_VOLUME_INFO        *Volume,
  OUT  UINT64                 *VolumeSize,
  OUT  UINT64                 *FreeSpaceSize
  );
 
EFI_STATUS
ReadFileData (
  IN      EFI_BLOCK_IO_PROTOCOL  *BlockIo,
  IN      EFI_DISK_IO_PROTOCOL   *DiskIo,
  IN      UDF_VOLUME_INFO        *Volume,
  IN      UDF_FILE_INFO          *File,
  IN      UINT64                 FileSize,
  IN OUT  UINT64                 *FilePosition,
  IN OUT  VOID                   *Buffer,
  IN OUT  UINT64                 *BufferSize
  );
 
EFI_STATUS
SupportUdfFileSystem (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle
  );
 
CHAR16 *
MangleFileName (
  IN CHAR16  *FileName
  );
 
EFI_STATUS
EFIAPI
UdfDriverBindingSupported (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath
  );
 
EFI_STATUS
EFIAPI
UdfDriverBindingStart (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath
  );
 
EFI_STATUS
EFIAPI
UdfDriverBindingStop (
  IN  EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN  EFI_HANDLE                   ControllerHandle,
  IN  UINTN                        NumberOfChildren,
  IN  EFI_HANDLE                   *ChildHandleBuffer
  );
 
//
// EFI Component Name Functions
//
 
EFI_STATUS
EFIAPI
UdfComponentNameGetDriverName (
  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
  IN  CHAR8                        *Language,
  OUT CHAR16                       **DriverName
  );
 
EFI_STATUS
EFIAPI
UdfComponentNameGetControllerName (
  IN   EFI_COMPONENT_NAME_PROTOCOL  *This,
  IN   EFI_HANDLE                   ControllerHandle,
  IN   EFI_HANDLE                   ChildHandle OPTIONAL,
  IN   CHAR8                        *Language,
  OUT  CHAR16                       **ControllerName
  );
 
#endif // _UDF_H_