diff options
author | eric_tian <eric_tian@6f19259b-4bc3-4df7-8a09-765794883524> | 2009-07-10 10:17:40 +0000 |
---|---|---|
committer | eric_tian <eric_tian@6f19259b-4bc3-4df7-8a09-765794883524> | 2009-07-10 10:17:40 +0000 |
commit | bab0c17ae98fa6bf9658e9c565fa242e03a2fab7 (patch) | |
tree | d756879f2e7ac3836f9623972f13f8d2667b9cce /IntelFrameworkModulePkg | |
parent | 1257e058d71e51c2700f1cde036c9f29fc7d3545 (diff) | |
download | edk2-bab0c17ae98fa6bf9658e9c565fa242e03a2fab7.tar.gz edk2-bab0c17ae98fa6bf9658e9c565fa242e03a2fab7.tar.bz2 edk2-bab0c17ae98fa6bf9658e9c565fa242e03a2fab7.zip |
update the function header comment to comply with PI1.2 volume 5
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8879 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'IntelFrameworkModulePkg')
-rw-r--r-- | IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.c | 65 | ||||
-rw-r--r-- | IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h | 65 |
2 files changed, 64 insertions, 66 deletions
diff --git a/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.c b/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.c index bf094c0ffb..224b2cac8d 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.c +++ b/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.c @@ -1247,17 +1247,17 @@ IDEBlkIoFlushBlocks ( }
/**
- Return the results of the Inquiry command to a drive in InquiryData.
- Data format of Inquiry data is defined by the Interface GUID.
+ This function is used by the IDE bus driver to get inquiry data.
+ Data format of Identify data is defined by the Interface GUID.
- @param This Protocol Instance pointer.
- @param InquiryData Results of Inquiry command to device
- @param InquiryDataSize Size of InquiryData in bytes.
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param InquiryData Pointer to a buffer for the inquiry data.
+ @param InquiryDataSize Pointer to the value for the inquiry data size.
- @retval EFI_SUCCESS InquiryData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading InquiryData from device
- @retval EFI_BUFFER_TOO_SMALL IntquiryDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading InquiryData from device
+ @retval EFI_BUFFER_TOO_SMALL IntquiryDataSize not big enough
**/
EFI_STATUS
@@ -1288,17 +1288,17 @@ IDEDiskInfoInquiry ( }
/**
- Return the results of the Identify command to a drive in IdentifyData.
+ This function is used by the IDE bus driver to get identify data.
Data format of Identify data is defined by the Interface GUID.
- @param This Protocol instance pointer.
- @param IdentifyData Results of Identify command to device
- @param IdentifyDataSize Size of IdentifyData in bytes.
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param IdentifyData Pointer to a buffer for the identify data.
+ @param IdentifyDataSize Pointer to the value for the identify data size.
- @retval EFI_SUCCESS IdentifyData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading IdentifyData from device
- @retval EFI_BUFFER_TOO_SMALL IdentifyDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading IdentifyData from device
+ @retval EFI_BUFFER_TOO_SMALL IdentifyDataSize not big enough
**/
EFI_STATUS
@@ -1329,18 +1329,18 @@ IDEDiskInfoIdentify ( }
/**
- Return the results of the Request Sense command to a drive in SenseData.
+ This function is used by the IDE bus driver to get sense data.
Data format of Sense data is defined by the Interface GUID.
- @param This Protocol instance pointer.
- @param SenseData Results of Request Sense command to device
- @param SenseDataSize Size of SenseData in bytes.
- @param SenseDataNumber Type of SenseData
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param SenseData Pointer to the SenseData.
+ @param SenseDataSize Size of SenseData in bytes.
+ @param SenseDataNumber Pointer to the value for the identify data size.
- @retval EFI_SUCCESS InquiryData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading InquiryData from device
- @retval EFI_BUFFER_TOO_SMALL SenseDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading InquiryData from device
+ @retval EFI_BUFFER_TOO_SMALL SenseDataSize not big enough
**/
EFI_STATUS
@@ -1356,15 +1356,14 @@ IDEDiskInfoSenseData ( }
/**
- Return the results of the Request Sense command to a drive in SenseData.
- Data format of Sense data is defined by the Interface GUID.
+ This function is used by the IDE bus driver to get controller information.
- @param This Protocol instance pointer.
- @param IdeChannel Primary or Secondary
- @param IdeDevice Master or Slave
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param IdeChannel Pointer to the Ide Channel number. Primary or secondary.
+ @param IdeDevice Pointer to the Ide Device number. Master or slave.
- @retval EFI_SUCCESS IdeChannel and IdeDevice are valid
- @retval EFI_UNSUPPORTED This is not an IDE device
+ @retval EFI_SUCCESS IdeChannel and IdeDevice are valid
+ @retval EFI_UNSUPPORTED This is not an IDE device
**/
EFI_STATUS
diff --git a/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h b/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h index 502d2dd92c..a9a084bc94 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h +++ b/IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h @@ -443,17 +443,17 @@ IDEBlkIoFlushBlocks ( IN EFI_BLOCK_IO_PROTOCOL *This
);
/**
- Return the results of the Inquiry command to a drive in InquiryData.
- Data format of Inquiry data is defined by the Interface GUID.
+ This function is used by the IDE bus driver to get inquiry data.
+ Data format of Identify data is defined by the Interface GUID.
- @param This Protocol instance pointer.
- @param InquiryData Results of Inquiry command to device
- @param InquiryDataSize Size of InquiryData in bytes.
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param InquiryData Pointer to a buffer for the inquiry data.
+ @param InquiryDataSize Pointer to the value for the inquiry data size.
- @retval EFI_SUCCESS InquiryData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading InquiryData from device
- @retval EFI_BUFFER_TOO_SMALL InquiryDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading InquiryData from device
+ @retval EFI_BUFFER_TOO_SMALL IntquiryDataSize not big enough
**/
EFI_STATUS
@@ -465,17 +465,17 @@ IDEDiskInfoInquiry ( );
/**
- Return the results of the Identify command to a drive in IdentifyData.
+ This function is used by the IDE bus driver to get identify data.
Data format of Identify data is defined by the Interface GUID.
- @param This Protocol instance pointer.
- @param IdentifyData Results of Identify command to device
- @param IdentifyDataSize Size of IdentifyData in bytes.
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param IdentifyData Pointer to a buffer for the identify data.
+ @param IdentifyDataSize Pointer to the value for the identify data size.
- @retval EFI_SUCCESS IdentifyData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading IdentifyData from device
- @retval EFI_BUFFER_TOO_SMALL IdentifyDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading IdentifyData from device
+ @retval EFI_BUFFER_TOO_SMALL IdentifyDataSize not big enough
**/
EFI_STATUS
@@ -487,18 +487,18 @@ IDEDiskInfoIdentify ( );
/**
- Return the results of the Request Sense command to a drive in SenseData.
+ This function is used by the IDE bus driver to get sense data.
Data format of Sense data is defined by the Interface GUID.
- @param This Protocol instance pointer.
- @param SenseData Results of Request Sense command to device
- @param SenseDataSize Size of SenseData in bytes.
- @param SenseDataNumber Type of SenseData
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param SenseData Pointer to the SenseData.
+ @param SenseDataSize Size of SenseData in bytes.
+ @param SenseDataNumber Pointer to the value for the identify data size.
- @retval EFI_SUCCESS InquiryData valid
- @retval EFI_NOT_FOUND Device does not support this data class
- @retval EFI_DEVICE_ERROR Error reading InquiryData from device
- @retval EFI_BUFFER_TOO_SMALL SenseDataSize not big enough
+ @retval EFI_SUCCESS The command was accepted without any errors.
+ @retval EFI_NOT_FOUND Device does not support this data class
+ @retval EFI_DEVICE_ERROR Error reading InquiryData from device
+ @retval EFI_BUFFER_TOO_SMALL SenseDataSize not big enough
**/
EFI_STATUS
@@ -511,15 +511,14 @@ IDEDiskInfoSenseData ( );
/**
- Return the results of the Request Sense command to a drive in SenseData.
- Data format of Sense data is defined by the Interface GUID.
+ This function is used by the IDE bus driver to get controller information.
- @param This Protocol instance pointer.
- @param IdeChannel Primary or Secondary
- @param IdeDevice Master or Slave
+ @param This Pointer to the EFI_DISK_INFO_PROTOCOL instance.
+ @param IdeChannel Pointer to the Ide Channel number. Primary or secondary.
+ @param IdeDevice Pointer to the Ide Device number. Master or slave.
- @retval EFI_SUCCESS IdeChannel and IdeDevice are valid
- @retval EFI_UNSUPPORTED This is not an IDE device
+ @retval EFI_SUCCESS IdeChannel and IdeDevice are valid
+ @retval EFI_UNSUPPORTED This is not an IDE device
**/
EFI_STATUS
|