37de2c8442
As it is unlikely for any user code to directly use this definition, this update should not cause any build break issue. git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10598 6f19259b-4bc3-4df7-8a09-765794883524
193 lines
7.1 KiB
C
193 lines
7.1 KiB
C
/** @file
|
|
EFI_DEVICE_PATH_UTILITIES_PROTOCOL as defined in UEFI 2.0.
|
|
Use to create and manipulate device paths and device nodes.
|
|
|
|
Copyright (c) 2006 - 2010, 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.
|
|
|
|
**/
|
|
|
|
#ifndef __DEVICE_PATH_UTILITIES_PROTOCOL_H__
|
|
#define __DEVICE_PATH_UTILITIES_PROTOCOL_H__
|
|
|
|
///
|
|
/// Device Path Utilities protocol
|
|
///
|
|
#define EFI_DEVICE_PATH_UTILITIES_PROTOCOL_GUID \
|
|
{ \
|
|
0x379be4e, 0xd706, 0x437d, {0xb0, 0x37, 0xed, 0xb8, 0x2f, 0xb7, 0x72, 0xa4 } \
|
|
}
|
|
|
|
/**
|
|
Returns the size of the device path, in bytes.
|
|
|
|
@param DevicePath Points to the start of the EFI device path.
|
|
|
|
@return Size Size of the specified device path, in bytes, including the end-of-path tag.
|
|
@retval 0 DevicePath is NULL
|
|
|
|
**/
|
|
typedef
|
|
UINTN
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_GET_DEVICE_PATH_SIZE)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath
|
|
);
|
|
|
|
|
|
/**
|
|
Create a duplicate of the specified path.
|
|
|
|
@param DevicePath Points to the source EFI device path.
|
|
|
|
@retval Pointer A pointer to the duplicate device path.
|
|
@retval NULL insufficient memory or DevicePath is NULL
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_DUP_DEVICE_PATH)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath
|
|
);
|
|
|
|
/**
|
|
Create a new path by appending the second device path to the first.
|
|
If Src1 is NULL and Src2 is non-NULL, then a duplicate of Src2 is returned.
|
|
If Src1 is non-NULL and Src2 is NULL, then a duplicate of Src1 is returned.
|
|
If Src1 and Src2 are both NULL, then a copy of an end-of-device-path is returned.
|
|
|
|
@param Src1 Points to the first device path.
|
|
@param Src2 Points to the second device path.
|
|
|
|
@retval Pointer A pointer to the newly created device path.
|
|
@retval NULL Memory could not be allocated
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_PATH)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *Src1,
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *Src2
|
|
);
|
|
|
|
/**
|
|
Creates a new path by appending the device node to the device path.
|
|
If DeviceNode is NULL then a copy of DevicePath is returned.
|
|
If DevicePath is NULL then a copy of DeviceNode, followed by an end-of-device path device node is returned.
|
|
If both DeviceNode and DevicePath are NULL then a copy of an end-of-device-path device node is returned.
|
|
|
|
@param DevicePath Points to the device path.
|
|
@param DeviceNode Points to the device node.
|
|
|
|
@retval Pointer A pointer to the allocated device node.
|
|
@retval NULL There was insufficient memory.
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_NODE)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DeviceNode
|
|
);
|
|
|
|
/**
|
|
Creates a new path by appending the specified device path instance to the specified device path.
|
|
|
|
@param DevicePath Points to the device path. If NULL, then ignored.
|
|
@param DevicePathInstance Points to the device path instance.
|
|
|
|
@retval Pointer A pointer to the newly created device path
|
|
@retval NULL Memory could not be allocated or DevicePathInstance is NULL.
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_INSTANCE)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePathInstance
|
|
);
|
|
|
|
/**
|
|
Creates a copy of the current device path instance and returns a pointer to the next device path
|
|
instance.
|
|
|
|
@param DevicePathInstance On input, this holds the pointer to the current device path
|
|
instance. On output, this holds the pointer to the next
|
|
device path instance or NULL if there are no more device
|
|
path instances in the device path.
|
|
@param DevicePathInstanceSize On output, this holds the size of the device path instance,
|
|
in bytes or zero, if DevicePathInstance is NULL.
|
|
If NULL, then the instance size is not output.
|
|
|
|
@retval Pointer A pointer to the copy of the current device path instance.
|
|
@retval NULL DevicePathInstace was NULL on entry or there was insufficient memory.
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_GET_NEXT_INSTANCE)(
|
|
IN OUT EFI_DEVICE_PATH_PROTOCOL **DevicePathInstance,
|
|
OUT UINTN *DevicePathInstanceSize
|
|
);
|
|
|
|
/**
|
|
Creates a device node
|
|
|
|
@param NodeType NodeType is the device node type (EFI_DEVICE_PATH.Type) for
|
|
the new device node.
|
|
@param NodeSubType NodeSubType is the device node sub-type
|
|
EFI_DEVICE_PATH.SubType) for the new device node.
|
|
@param NodeLength NodeLength is the length of the device node
|
|
(EFI_DEVICE_PATH.Length) for the new device node.
|
|
|
|
@retval Pointer A pointer to the newly created device node.
|
|
@retval NULL NodeLength is less than
|
|
the size of the header or there was insufficient memory.
|
|
|
|
**/
|
|
typedef
|
|
EFI_DEVICE_PATH_PROTOCOL*
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_CREATE_NODE)(
|
|
IN UINT8 NodeType,
|
|
IN UINT8 NodeSubType,
|
|
IN UINT16 NodeLength
|
|
);
|
|
|
|
/**
|
|
Returns whether a device path is multi-instance.
|
|
|
|
@param DevicePath Points to the device path. If NULL, then ignored.
|
|
|
|
@retval TRUE The device path has more than one instance
|
|
@retval FALSE The device path is empty or contains only a single instance.
|
|
|
|
**/
|
|
typedef
|
|
BOOLEAN
|
|
(EFIAPI *EFI_DEVICE_PATH_UTILS_IS_MULTI_INSTANCE)(
|
|
IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath
|
|
);
|
|
|
|
///
|
|
/// This protocol is used to creates and manipulates device paths and device nodes.
|
|
///
|
|
typedef struct {
|
|
EFI_DEVICE_PATH_UTILS_GET_DEVICE_PATH_SIZE GetDevicePathSize;
|
|
EFI_DEVICE_PATH_UTILS_DUP_DEVICE_PATH DuplicateDevicePath;
|
|
EFI_DEVICE_PATH_UTILS_APPEND_PATH AppendDevicePath;
|
|
EFI_DEVICE_PATH_UTILS_APPEND_NODE AppendDeviceNode;
|
|
EFI_DEVICE_PATH_UTILS_APPEND_INSTANCE AppendDevicePathInstance;
|
|
EFI_DEVICE_PATH_UTILS_GET_NEXT_INSTANCE GetNextDevicePathInstance;
|
|
EFI_DEVICE_PATH_UTILS_IS_MULTI_INSTANCE IsDevicePathMultiInstance;
|
|
EFI_DEVICE_PATH_UTILS_CREATE_NODE CreateDeviceNode;
|
|
} EFI_DEVICE_PATH_UTILITIES_PROTOCOL;
|
|
|
|
extern EFI_GUID gEfiDevicePathUtilitiesProtocolGuid;
|
|
|
|
#endif
|