summaryrefslogtreecommitdiff
path: root/IntelFrameworkModulePkg
diff options
context:
space:
mode:
authoreric_tian <eric_tian@6f19259b-4bc3-4df7-8a09-765794883524>2009-07-10 10:17:40 +0000
committereric_tian <eric_tian@6f19259b-4bc3-4df7-8a09-765794883524>2009-07-10 10:17:40 +0000
commitbab0c17ae98fa6bf9658e9c565fa242e03a2fab7 (patch)
treed756879f2e7ac3836f9623972f13f8d2667b9cce /IntelFrameworkModulePkg
parent1257e058d71e51c2700f1cde036c9f29fc7d3545 (diff)
downloadedk2-platforms-bab0c17ae98fa6bf9658e9c565fa242e03a2fab7.tar.xz
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.c65
-rw-r--r--IntelFrameworkModulePkg/Bus/Pci/IdeBusDxe/IdeBus.h65
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