Device IO is used to abstract hardware access to devices. It includes\r
memory mapped IO, IO, PCI Config space, and DMA.\r
\r
- Copyright (c) 2006 - 2008, Intel Corporation \r
- All rights reserved. This program and the accompanying materials \r
+ Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>\r
+ This program and the accompanying materials \r
are licensed and made available under the terms and conditions of the BSD License \r
which accompanies this distribution. The full text of the license may be found at \r
http://opensource.org/licenses/bsd-license.php \r
/// \r
typedef EFI_DEVICE_IO_PROTOCOL EFI_DEVICE_IO_INTERFACE;\r
\r
+///\r
+/// Device IO Access Width \r
+///\r
typedef enum {\r
- IO_UINT8 = 0,\r
- IO_UINT16 = 1,\r
- IO_UINT32 = 2,\r
- IO_UINT64 = 3,\r
- MMIO_COPY_UINT8 = 4,\r
- MMIO_COPY_UINT16 = 5,\r
- MMIO_COPY_UINT32 = 6,\r
- MMIO_COPY_UINT64 = 7\r
+ IO_UINT8 = 0,\r
+ IO_UINT16 = 1,\r
+ IO_UINT32 = 2,\r
+ IO_UINT64 = 3,\r
+ //\r
+ // Below enumerations are added in "Extensible Firmware Interface Specification, \r
+ // Version 1.10, Specification Update, Version 001".\r
+ //\r
+ MMIO_COPY_UINT8 = 4,\r
+ MMIO_COPY_UINT16 = 5,\r
+ MMIO_COPY_UINT32 = 6,\r
+ MMIO_COPY_UINT64 = 7\r
} EFI_IO_WIDTH;\r
\r
/** \r
@param Count The number of I/O operations to perform.\r
@param Buffer For read operations, the destination buffer to store the results. For write\r
operations, the source buffer to write data from. If\r
- Width is MMIO_COPY_UINT8, MMIO_COPY_UINT16,\r
- MMIO_COPY_UINT32, or MMIO_COPY_UINT64, then\r
- Buffer is interpreted as a base address of an I/O operation such as Address. \r
+ Width is MMIO_COPY_UINT8, MMIO_COPY_UINT16,\r
+ MMIO_COPY_UINT32, or MMIO_COPY_UINT64, then\r
+ Buffer is interpreted as a base address of an I/O operation such as Address. \r
\r
@retval EFI_SUCCESS The data was read from or written to the device.\r
@retval EFI_OUT_OF_RESOURCES The request could not be completed due to a lack of resources. \r
///\r
/// Provides both read and write access to system memory\r
/// by both the processor and a bus master. The buffer is\r
- /// coherent from both the processor¡¯s and the bus master¡¯s\r
+ /// coherent from both the processor's and the bus master's\r
/// point of view.\r
///\r
EfiBusMasterCommonBuffer\r
@param This A pointer to the EFI_DEVICE_IO_INTERFACE instance.\r
@param Operation Indicates if the bus master is going to read or write to system memory.\r
@param HostAddress The system memory address to map to the device.\r
- @param NumberOfBytes On input the number of bytes to map.\r
+ @param NumberOfBytes On input, the number of bytes to map.\r
+ On output, the number of bytes that were mapped.\r
@param DeviceAddress The resulting map address for the bus master device to use to access the\r
hosts HostAddress.\r
@param Mapping A resulting value to pass to Unmap().\r