* [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
@ 2023-02-20 18:45 Rebecca Cran
2023-02-21 1:58 ` [edk2-devel] " Tinh Nguyen
` (2 more replies)
0 siblings, 3 replies; 7+ messages in thread
From: Rebecca Cran @ 2023-02-20 18:45 UTC (permalink / raw)
To: devel, Michael D Kinney, Liming Gao, Zhiguang Liu; +Cc: Rebecca Cran
There isn't supposed to be whitespace for "@param [in,out]" between "in"
and "out". clang generates the following warning:
test.c:8:9: warning: whitespace is not allowed in parameter passing direction [-Wdocumentation-pedantic]
@param [in, out] argv Array of arguments.
^~~~~~~~~
[in,out]
Update the documentation blocks in MdePkg.
Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
---
MdePkg/Include/Library/BaseLib.h | 4 +-
MdePkg/Include/Library/FileHandleLib.h | 12 +-
MdePkg/Include/Library/PcdLib.h | 14 +--
MdePkg/Include/Library/SmmPeriodicSmiLib.h | 2 +-
MdePkg/Include/Library/UefiScsiLib.h | 124 ++++++++++----------
MdePkg/Include/Ppi/CpuIo.h | 2 +-
MdePkg/Include/Ppi/Graphics.h | 2 +-
MdePkg/Include/Ppi/Pcd.h | 10 +-
MdePkg/Include/Ppi/PiPcd.h | 2 +-
MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h | 2 +-
MdePkg/Include/Protocol/BlockIo2.h | 4 +-
MdePkg/Include/Protocol/BlockIoCrypto.h | 6 +-
MdePkg/Include/Protocol/BluetoothHc.h | 4 +-
MdePkg/Include/Protocol/BluetoothIo.h | 4 +-
MdePkg/Include/Protocol/BluetoothLeConfig.h | 10 +-
MdePkg/Include/Protocol/CcMeasurement.h | 2 +-
MdePkg/Include/Protocol/CpuIo2.h | 2 +-
MdePkg/Include/Protocol/Eap.h | 2 +-
MdePkg/Include/Protocol/EapConfiguration.h | 4 +-
MdePkg/Include/Protocol/EapManagement.h | 2 +-
MdePkg/Include/Protocol/EapManagement2.h | 8 +-
MdePkg/Include/Protocol/EraseBlock.h | 2 +-
MdePkg/Include/Protocol/FirmwareManagement.h | 6 +-
MdePkg/Include/Protocol/I2cEnumerate.h | 2 +-
MdePkg/Include/Protocol/IpSec.h | 16 +--
MdePkg/Include/Protocol/IpSecConfig.h | 6 +-
MdePkg/Include/Protocol/Kms.h | 72 ++++++------
MdePkg/Include/Protocol/MmCommunication2.h | 6 +-
MdePkg/Include/Protocol/MmSwDispatch.h | 2 +-
MdePkg/Include/Protocol/Mtftp6.h | 2 +-
MdePkg/Include/Protocol/Pcd.h | 8 +-
MdePkg/Include/Protocol/PiPcd.h | 2 +-
MdePkg/Include/Protocol/S3SaveState.h | 4 +-
MdePkg/Include/Protocol/Shell.h | 8 +-
MdePkg/Include/Protocol/SmartCardEdge.h | 12 +-
MdePkg/Include/Protocol/SmartCardReader.h | 10 +-
MdePkg/Include/Protocol/Smbios.h | 4 +-
MdePkg/Include/Protocol/SmmSwDispatch2.h | 2 +-
MdePkg/Include/Protocol/SuperIo.h | 2 +-
MdePkg/Include/Protocol/Supplicant.h | 6 +-
MdePkg/Include/Protocol/Tcg2Protocol.h | 2 +-
MdePkg/Include/Protocol/Tls.h | 8 +-
MdePkg/Include/Protocol/TlsConfig.h | 4 +-
MdePkg/Include/Protocol/UfsDeviceConfig.h | 10 +-
MdePkg/Include/Protocol/UsbFunctionIo.h | 12 +-
MdePkg/Include/Protocol/UserCredential.h | 4 +-
MdePkg/Include/Protocol/UserCredential2.h | 4 +-
MdePkg/Include/Uefi/UefiSpec.h | 22 ++--
| 2 +-
MdePkg/Library/BaseLib/QuickSort.c | 2 +-
MdePkg/Library/BasePcdLibNull/PcdLib.c | 12 +-
MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c | 8 +-
MdePkg/Library/DxePcdLib/DxePcdLib.c | 12 +-
| 2 +-
MdePkg/Library/PeiPcdLib/PeiPcdLib.c | 12 +-
MdePkg/Library/SmmIoLib/SmmIoLib.c | 4 +-
MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c | 8 +-
MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c | 12 +-
MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 124 ++++++++++----------
59 files changed, 329 insertions(+), 329 deletions(-)
diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/BaseLib.h
index 8f2df76c29a3..0dee0f58aa75 100644
--- a/MdePkg/Include/Library/BaseLib.h
+++ b/MdePkg/Include/Library/BaseLib.h
@@ -2482,7 +2482,7 @@ BcdToDecimal8 (
/**
Removes the last directory or file entry in a path.
- @param[in, out] Path The pointer to the path to modify.
+ @param[in,out] Path The pointer to the path to modify.
@retval FALSE Nothing was found to remove.
@retval TRUE A directory or file was removed.
@@ -2930,7 +2930,7 @@ INTN
if Count is < 2 then perform no action.
- @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
+ @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes
diff --git a/MdePkg/Include/Library/FileHandleLib.h b/MdePkg/Include/Library/FileHandleLib.h
index 1a238edee38c..2ea97c317c27 100644
--- a/MdePkg/Include/Library/FileHandleLib.h
+++ b/MdePkg/Include/Library/FileHandleLib.h
@@ -78,7 +78,7 @@ FileHandleSetInfo (
EFI_FILE_INFO is the structure returned as the directory entry.
@param[in] FileHandle The opened file handle.
- @param[in, out] BufferSize On input, the size of buffer in bytes. On return,
+ @param[in,out] BufferSize On input, the size of buffer in bytes. On return,
the number of bytes written.
@param[out] Buffer The buffer to put read data into.
@@ -109,7 +109,7 @@ FileHandleRead (
opened directories are not supported.
@param[in] FileHandle The opened file for writing.
- @param[in, out] BufferSize On input, the number of bytes in Buffer. On output,
+ @param[in,out] BufferSize On input, the number of bytes in Buffer. On output,
the number of bytes written.
@param[in] Buffer The buffer containing data to write is stored.
@@ -381,15 +381,15 @@ FileHandleGetFileName (
read a CHAR_NULL character will be returned in buffer.
@param[in] Handle FileHandle to read from.
- @param[in, out] Buffer The pointer to buffer to read into.
- @param[in, out] Size The pointer to number of bytes in Buffer.
+ @param[in,out] Buffer The pointer to buffer to read into.
+ @param[in,out] Size The pointer to number of bytes in Buffer.
@param[in] Truncate If the buffer is large enough, this has no effect.
If the buffer is is too small and Truncate is TRUE,
the line will be truncated.
If the buffer is is too small and Truncate is FALSE,
then no read will occur.
- @param[in, out] Ascii Boolean value for indicating whether the file is
+ @param[in,out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@retval EFI_SUCCESS The operation was successful. The line is stored in
@@ -418,7 +418,7 @@ FileHandleReadLine (
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from.
- @param[in, out] Ascii Boolean value for indicating whether the file is
+ @param[in,out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@return The line of text from the file.
diff --git a/MdePkg/Include/Library/PcdLib.h b/MdePkg/Include/Library/PcdLib.h
index 4b103f0753c5..86739a3b2bd1 100644
--- a/MdePkg/Include/Library/PcdLib.h
+++ b/MdePkg/Include/Library/PcdLib.h
@@ -1158,7 +1158,7 @@ LibPcdSet64S (
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -1303,7 +1303,7 @@ LibPcdSetEx64S (
@param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -1354,7 +1354,7 @@ LibPcdSetExBoolS (
@param[in] CallBackGuid The PCD token GUID being set.
@param[in] CallBackToken The PCD token number being set.
- @param[in, out] TokenData A pointer to the token data being set.
+ @param[in,out] TokenData A pointer to the token data being set.
@param[in] TokenDataSize The size, in bytes, of the data being set.
**/
@@ -1474,7 +1474,7 @@ LibPcdGetNextTokenSpace (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the Buffer that was set.
@@ -1506,7 +1506,7 @@ LibPatchPcdSetPtr (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
@@ -1540,7 +1540,7 @@ LibPatchPcdSetPtrS (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the Buffer that was set.
@@ -1575,7 +1575,7 @@ LibPatchPcdSetPtrAndSize (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
diff --git a/MdePkg/Include/Library/SmmPeriodicSmiLib.h b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
index 83d9bdde0eb8..dd3745d65af8 100644
--- a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
+++ b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
@@ -104,7 +104,7 @@ VOID
/**
This function enables a periodic SMI handler.
- @param[in, out] DispatchHandle A pointer to the handle associated with the
+ @param[in,out] DispatchHandle A pointer to the handle associated with the
enabled periodic SMI handler. This is an
optional parameter that may be NULL. If it is
NULL, then the handle will not be returned,
diff --git a/MdePkg/Include/Library/UefiScsiLib.h b/MdePkg/Include/Library/UefiScsiLib.h
index da6ac2df68e7..90db37456ad2 100644
--- a/MdePkg/Include/Library/UefiScsiLib.h
+++ b/MdePkg/Include/Library/UefiScsiLib.h
@@ -39,12 +39,12 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
is greater than zero, then this function will return
EFI_TIMEOUT if the time required to execute the SCSI
Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated by
+ @param[in,out] SenseData A pointer to sense data that was generated by
the execution of the SCSI Request Packet. This
buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter is
optional and may be NULL.
- @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
+ @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
the SenseData buffer. On output, a pointer to
the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
@@ -122,12 +122,12 @@ ScsiTestUnitReadyCommand (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI
@@ -141,12 +141,12 @@ ScsiTestUnitReadyCommand (
See the EFI SCSI I/O Protocol in the UEFI
Specification for details on the possible
return values.
- @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
+ @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If InquiryDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
+ @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
of the InquiryDataBuffer buffer.
On output, a pointer to the number of bytes
written to the InquiryDataBuffer buffer.
@@ -223,12 +223,12 @@ ScsiInquiryCommand (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI
@@ -242,12 +242,12 @@ ScsiInquiryCommand (
See the EFI SCSI I/O Protocol in the UEFI
Specification for details on the possible
return values.
- @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
+ @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If InquiryDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
+ @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
of the InquiryDataBuffer buffer.
On output, a pointer to the number of bytes
written to the InquiryDataBuffer buffer.
@@ -329,12 +329,12 @@ ScsiInquiryCommandEx (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI target
@@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
on the SCSI Host Controller. See the EFI SCSI
I/O Protocol in the UEFI Specification for details
on the possible return values.
- @param[in, out] DataBuffer A pointer to data that was generated by the
+ @param[in,out] DataBuffer A pointer to data that was generated by the
execution of the SCSI Request Packet. This
buffer must be allocated by the caller. If
DataLength is 0, then this parameter is optional
and may be NULL.
- @param[in, out] DataLength On input, a pointer to the length in bytes of
+ @param[in,out] DataLength On input, a pointer to the length in bytes of
the DataBuffer buffer. On output, a pointer
to the number of bytes written to the DataBuffer
buffer.
@@ -420,8 +420,8 @@ ScsiModeSense10Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@@ -469,12 +469,12 @@ ScsiRequestSenseCommand (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] Pmi Partial medium indicator.
@retval EFI_SUCCESS Command is executed successfully.
@@ -527,12 +527,12 @@ ScsiReadCapacityCommand (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] Pmi Partial medium indicator.
@retval EFI_SUCCESS Command is executed successfully.
@@ -586,12 +586,12 @@ ScsiReadCapacity16Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 10 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 10 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -646,12 +646,12 @@ ScsiRead10Command (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -706,12 +706,12 @@ ScsiWrite10Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -766,12 +766,12 @@ ScsiRead16Command (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -825,8 +825,8 @@ ScsiWrite16Command (
@param[in] ScsiIo SCSI IO Protocol to use.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@param[in] SecurityProtocol The Security Protocol to use.
@@ -834,7 +834,7 @@ ScsiWrite16Command (
@param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
SECURITY PROTOCOL IN command.
@param[in] DataLength The size in bytes of the data buffer.
- @param[in, out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
@param[out] TransferLength A pointer to a buffer to store the size in
bytes of the data written to the data buffer.
@@ -889,8 +889,8 @@ ScsiSecurityProtocolInCommand (
@param[in] ScsiIo SCSI IO Protocol to use.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@param[in] SecurityProtocol The Security Protocol to use.
@@ -898,7 +898,7 @@ ScsiSecurityProtocolInCommand (
@param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
SECURITY PROTOCOL OUT command.
@param[in] DataLength The size in bytes of the transfer data.
- @param[in, out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
@retval EFI_SUCCESS Command is executed successfully.
@retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
@@ -960,12 +960,12 @@ ScsiSecurityProtocolOutCommand (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -1049,12 +1049,12 @@ ScsiRead10CommandEx (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -1138,12 +1138,12 @@ ScsiWrite10CommandEx (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -1227,12 +1227,12 @@ ScsiRead16CommandEx (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
index 193a78e3c256..5e2ca4edbc22 100644
--- a/MdePkg/Include/Ppi/CpuIo.h
+++ b/MdePkg/Include/Ppi/CpuIo.h
@@ -46,7 +46,7 @@ typedef enum {
@param[in] Width The width of the access. Enumerated in bytes.
@param[in] Address The physical address of the access.
@param[in] Count The number of accesses to perform.
- @param[in, out] Buffer A pointer to the buffer of data.
+ @param[in,out] Buffer A pointer to the buffer of data.
@retval EFI_SUCCESS The function completed successfully.
@retval EFI_NOT_YET_AVAILABLE The service has not been installed.
diff --git a/MdePkg/Include/Ppi/Graphics.h b/MdePkg/Include/Ppi/Graphics.h
index 3854f6c371c2..e8c1bc14b0ac 100644
--- a/MdePkg/Include/Ppi/Graphics.h
+++ b/MdePkg/Include/Ppi/Graphics.h
@@ -48,7 +48,7 @@ EFI_STATUS
The GraphicsPpiGetMode returns the mode information supported by the Graphics PEI
Module.
- @param[in, out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
+ @param[in,out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
@retval EFI_SUCCESS Valid mode information was returned.
@retval EFI_INVALID_PARAMETER The Mode parameter is not valid.
diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
index d36a7f106cc8..3e6556314d1b 100644
--- a/MdePkg/Include/Ppi/Pcd.h
+++ b/MdePkg/Include/Ppi/Pcd.h
@@ -420,7 +420,7 @@ EFI_STATUS
If it is not, an error will be returned.
@param[in] TokenNumber The PCD token number.
- @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
+ @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
On input, if the SizeOfValue is greater than the maximum size supported
for this TokenNumber then the output value of SizeOfValue will reflect
the maximum size supported for this TokenNumber.
@@ -578,7 +578,7 @@ EFI_STATUS
@param[in] Guid The 128-bit unique value that designates the namespace from which to extract the value.
@param[in] TokenNumber The PCD token number.
- @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
+ @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
On input, if the SizeOfValue is greater than the maximum size supported
for this TokenNumber then the output value of SizeOfValue will reflect
the maximum size supported for this TokenNumber.
@@ -638,7 +638,7 @@ EFI_STATUS
@param[in] CallBackGuid The PCD token GUID being set.
@param[in] CallBackToken The PCD token number being set.
- @param[in, out] TokenData A pointer to the token data being set.
+ @param[in,out] TokenData A pointer to the token data being set.
@param[in] TokenDataSize The size, in bytes, of the data being set.
@retval VOID
@@ -712,7 +712,7 @@ EFI_STATUS
@param[in] Guid The 128-bit unique value that designates the namespace from which to extract the value.
This is an optional parameter that may be NULL. If this parameter is NULL, then a request
is being made to retrieve tokens from the default token space.
- @param[in, out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
+ @param[in,out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
@retval EFI_SUCCESS The PCD service has retrieved the next valid token number.
@retval EFI_NOT_FOUND The PCD service could not find data from the requested token number.
@@ -731,7 +731,7 @@ EFI_STATUS
Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
token namespaces on a platform.
- @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
+ @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
namespace from which the search will start. On output, it designates the next valid
token namespace on the platform. If *Guid is NULL, then the GUID of the first token
space of the current platform is returned. If the search cannot locate the next valid
diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
index 8d0f95eb27cc..8b137f2ca9e2 100644
--- a/MdePkg/Include/Ppi/PiPcd.h
+++ b/MdePkg/Include/Ppi/PiPcd.h
@@ -387,7 +387,7 @@ EFI_STATUS
Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
token namespaces on a platform.
- @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
+ @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
namespace from which the search will start. On output, it designates the next valid
token namespace on the platform. If *Guid is NULL, then the GUID of the first token
space of the current platform is returned. If the search cannot locate the next valid
diff --git a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
index 9e134200da54..f25c3a7cd641 100644
--- a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
+++ b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
@@ -162,7 +162,7 @@ EFI_STATUS
Return the child ACPI objects.
@param[in] ParentHandle Parent handle.
- @param[in, out] Handle On entry, points to the previously returned handle or NULL to start with the first
+ @param[in,out] Handle On entry, points to the previously returned handle or NULL to start with the first
handle. On return, points to the next returned ACPI handle or NULL if there are no
child objects.
diff --git a/MdePkg/Include/Protocol/BlockIo2.h b/MdePkg/Include/Protocol/BlockIo2.h
index d25f51f73354..9bd5e7a6ddd9 100644
--- a/MdePkg/Include/Protocol/BlockIo2.h
+++ b/MdePkg/Include/Protocol/BlockIo2.h
@@ -72,7 +72,7 @@ EFI_STATUS
@param[in] MediaId Id of the media, changes every time the media is
replaced.
@param[in] Lba The starting Logical Block Address to read from.
- @param[in, out] Token A pointer to the token associated with the transaction.
+ @param[in,out] Token A pointer to the token associated with the transaction.
@param[in] BufferSize Size of Buffer, must be a multiple of device block size.
@param[out] Buffer A pointer to the destination buffer for the data. The
caller is responsible for either having implicit or
@@ -116,7 +116,7 @@ EFI_STATUS
@param[in] Lba The starting logical block address to be written. The
caller is responsible for writing to only legitimate
locations.
- @param[in, out] Token A pointer to the token associated with the transaction.
+ @param[in,out] Token A pointer to the token associated with the transaction.
@param[in] BufferSize Size of Buffer, must be a multiple of device block size.
@param[in] Buffer A pointer to the source buffer for the data.
diff --git a/MdePkg/Include/Protocol/BlockIoCrypto.h b/MdePkg/Include/Protocol/BlockIoCrypto.h
index bcc0ed40beff..f15cde32f61b 100644
--- a/MdePkg/Include/Protocol/BlockIoCrypto.h
+++ b/MdePkg/Include/Protocol/BlockIoCrypto.h
@@ -356,7 +356,7 @@ EFI_STATUS
@param[in] MediaId The media ID that the read request is for.
@param[in] LBA The starting logical block address to read from on
the device.
- @param[in, out] Token A pointer to the token associated with the transaction.
+ @param[in,out] Token A pointer to the token associated with the transaction.
@param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
of the intrinsic block size of the device.
@param[out] Buffer A pointer to the destination buffer for the data. The
@@ -423,7 +423,7 @@ EFI_STATUS
@param[in] MediaId The media ID that the read request is for.
@param[in] LBA The starting logical block address to read from on
the device.
- @param[in, out] Token A pointer to the token associated with the transaction.
+ @param[in,out] Token A pointer to the token associated with the transaction.
@param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
of the intrinsic block size of the device.
@param[in] Buffer A pointer to the source buffer for the data.
@@ -482,7 +482,7 @@ EFI_STATUS
will not be signaled.
@param[in] This Pointer to the EFI_BLOCK_IO_CRYPTO_PROTOCOL instance.
- @param[in, out] Token A pointer to the token associated with the transaction.
+ @param[in,out] Token A pointer to the token associated with the transaction.
@retval EFI_SUCCESS The flush request was queued if Event is not NULL. All
outstanding data was written correctly to the device if
diff --git a/MdePkg/Include/Protocol/BluetoothHc.h b/MdePkg/Include/Protocol/BluetoothHc.h
index d75cb08f8928..29faf36fb7b7 100644
--- a/MdePkg/Include/Protocol/BluetoothHc.h
+++ b/MdePkg/Include/Protocol/BluetoothHc.h
@@ -164,7 +164,7 @@ EFI_STATUS
capability.
@param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
- @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
+ @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
specified by Buffer. On output, indicates the amount of
data actually transferred.
@param[in] Buffer A pointer to the buffer of data that will be transmitted to
@@ -200,7 +200,7 @@ EFI_STATUS
ACL data packet, including Handle, PB flag, BC flag, data length, and data.
@param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
- @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
+ @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
specified by Buffer. On output, indicates the amount of
data actually transferred.
@param[out] Buffer A pointer to the buffer of data that will be received from
diff --git a/MdePkg/Include/Protocol/BluetoothIo.h b/MdePkg/Include/Protocol/BluetoothIo.h
index 620bfbc961cc..b4f6aee73e55 100644
--- a/MdePkg/Include/Protocol/BluetoothIo.h
+++ b/MdePkg/Include/Protocol/BluetoothIo.h
@@ -105,7 +105,7 @@ EFI_STATUS
Send L2CAP message (including L2CAP header).
@param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
- @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
+ @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
On output, indicates the amount of data actually transferred.
@param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP layer.
@param[in] Timeout Indicating the transfer should be completed within this time frame. The units are in
@@ -212,7 +212,7 @@ EFI_STATUS
@param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
@param[in] Handle A handle created by EFI_BLUETOOTH_IO_PROTOCOL.L2CapConnect indicates which channel to send.
- @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
+ @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
On output, indicates the amount of data actually transferred.
@param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP layer.
@param[in] Timeout Indicating the transfer should be completed within this time frame. The units are in
diff --git a/MdePkg/Include/Protocol/BluetoothLeConfig.h b/MdePkg/Include/Protocol/BluetoothLeConfig.h
index 6331e60a8655..2ec8a48fc551 100644
--- a/MdePkg/Include/Protocol/BluetoothLeConfig.h
+++ b/MdePkg/Include/Protocol/BluetoothLeConfig.h
@@ -234,9 +234,9 @@ EFI_STATUS
@param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
@param[in] DataType Configuration data type.
- @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
+ @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
On output, indicates the amount of data actually returned.
- @param[in, out] Data A pointer to the buffer of data that will be returned.
+ @param[in,out] Data A pointer to the buffer of data that will be returned.
@retval EFI_SUCCESS The BluetoothLE configuration data is returned successfully.
@retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
@@ -293,9 +293,9 @@ EFI_STATUS
@param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
@param[in] DataType Configuration data type.
@param[in] BDAddr Remote BluetoothLE device address.
- @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
+ @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
On output, indicates the amount of data actually returned.
- @param[in, out] Data A pointer to the buffer of data that will be returned.
+ @param[in,out] Data A pointer to the buffer of data that will be returned.
@retval EFI_SUCCESS The remote BluetoothLE device configuration data is returned successfully.
@retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
@@ -464,7 +464,7 @@ typedef enum {
@param[in] BDAddr Remote BluetoothLE device address. For Local device setting, it
should be NULL.
@param[in] DataType Data type in EFI_BLUETOOTH_LE_SMP_DATA_TYPE.
- @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified
+ @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified
by Data. On output, indicates the amount of data actually returned.
@param[out] Data A pointer to the buffer of data that will be returned.
diff --git a/MdePkg/Include/Protocol/CcMeasurement.h b/MdePkg/Include/Protocol/CcMeasurement.h
index 4bf21fc42fa0..555356d56d66 100644
--- a/MdePkg/Include/Protocol/CcMeasurement.h
+++ b/MdePkg/Include/Protocol/CcMeasurement.h
@@ -139,7 +139,7 @@ typedef struct {
capability information and state information.
@param[in] This Indicates the calling context
- @param[in, out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
+ @param[in,out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
structure and sets the size field to the size of the structure allocated.
The callee fills in the fields with the EFI CC BOOT Service capability
information and the current CC information.
diff --git a/MdePkg/Include/Protocol/CpuIo2.h b/MdePkg/Include/Protocol/CpuIo2.h
index 39ddda62bfcf..baddbeb51de5 100644
--- a/MdePkg/Include/Protocol/CpuIo2.h
+++ b/MdePkg/Include/Protocol/CpuIo2.h
@@ -81,7 +81,7 @@ typedef enum {
@param[in] Address The base address of the I/O operation.
@param[in] Count The number of I/O operations to perform. The number
of bytes moved is Width size * Count, starting at Address.
- @param[in, out] Buffer For read operations, the destination buffer to store the results.
+ @param[in,out] Buffer For read operations, the destination buffer to store the results.
For write operations, the source buffer from which to write data.
@retval EFI_SUCCESS The data was read from or written to the PI system.
diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h
index 37b94b55c998..2c69772225ad 100644
--- a/MdePkg/Include/Protocol/Eap.h
+++ b/MdePkg/Include/Protocol/Eap.h
@@ -54,7 +54,7 @@ typedef VOID *EFI_PORT_HANDLE;
@param[in] RequestSize Packet size in bytes for the most recently received
EAP-Request packet.
@param[in] Buffer Pointer to the buffer to hold the built packet.
- @param[in, out] BufferSize Pointer to the buffer size in bytes.
+ @param[in,out] BufferSize Pointer to the buffer size in bytes.
On input, it is the buffer size provided by the caller.
On output, it is the buffer size in fact needed to contain
the packet.
diff --git a/MdePkg/Include/Protocol/EapConfiguration.h b/MdePkg/Include/Protocol/EapConfiguration.h
index 6fcddabcb7b2..4bd100677b55 100644
--- a/MdePkg/Include/Protocol/EapConfiguration.h
+++ b/MdePkg/Include/Protocol/EapConfiguration.h
@@ -114,8 +114,8 @@ EFI_STATUS
@param[in] This Pointer to the EFI_EAP_CONFIGURATION_PROTOCOL instance.
@param[in] EapType EAP type.
@param[in] DataType Configuration data type.
- @param[in, out] Data Pointer to configuration data.
- @param[in, out] DataSize Total size of configuration data. On input, it means
+ @param[in,out] Data Pointer to configuration data.
+ @param[in,out] DataSize Total size of configuration data. On input, it means
the size of Data buffer. On output, it means the size
of copied Data buffer if EFI_SUCCESS, and means the
size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
diff --git a/MdePkg/Include/Protocol/EapManagement.h b/MdePkg/Include/Protocol/EapManagement.h
index ea1b0d71e357..20f915e30cf5 100644
--- a/MdePkg/Include/Protocol/EapManagement.h
+++ b/MdePkg/Include/Protocol/EapManagement.h
@@ -294,7 +294,7 @@ EFI_STATUS
instance that indicates the calling context.
@param[out] CurrentState Returns the current state of the Supplicant PAE
state machine for the Port.
- @param[in, out] Configuration Returns the configuration of the operational
+ @param[in,out] Configuration Returns the configuration of the operational
parameters of the Supplicant PAE state machine
for the Port as required. This parameter can be
NULL to ignore reading the configuration.
diff --git a/MdePkg/Include/Protocol/EapManagement2.h b/MdePkg/Include/Protocol/EapManagement2.h
index ab42b04e1a04..768f82b6aab2 100644
--- a/MdePkg/Include/Protocol/EapManagement2.h
+++ b/MdePkg/Include/Protocol/EapManagement2.h
@@ -33,10 +33,10 @@ typedef struct _EFI_EAP_MANAGEMENT2_PROTOCOL EFI_EAP_MANAGEMENT2_PROTOCOL;
MAC layer driver can use MSK to derive more keys, e.g. PMK (Pairwise Master Key).
@param[in] This Pointer to the EFI_EAP_MANAGEMENT2_PROTOCOL instance.
- @param[in, out] Msk Pointer to MSK (Master Session Key) buffer.
- @param[in, out] MskSize MSK buffer size.
- @param[in, out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
- @param[in, out] EmskSize EMSK buffer size.
+ @param[in,out] Msk Pointer to MSK (Master Session Key) buffer.
+ @param[in,out] MskSize MSK buffer size.
+ @param[in,out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
+ @param[in,out] EmskSize EMSK buffer size.
@retval EFI_SUCCESS The operation completed successfully.
@retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
diff --git a/MdePkg/Include/Protocol/EraseBlock.h b/MdePkg/Include/Protocol/EraseBlock.h
index bfa5921400aa..5f71ccdf9a0e 100644
--- a/MdePkg/Include/Protocol/EraseBlock.h
+++ b/MdePkg/Include/Protocol/EraseBlock.h
@@ -45,7 +45,7 @@ typedef struct {
@param[in] LBA The starting logical block address to be
erased. The caller is responsible for erasing
only legitimate locations.
- @param[in, out] Token A pointer to the token associated with the
+ @param[in,out] Token A pointer to the token associated with the
transaction.
@param[in] Size The size in bytes to be erased. This must be
a multiple of the physical block size of the
diff --git a/MdePkg/Include/Protocol/FirmwareManagement.h b/MdePkg/Include/Protocol/FirmwareManagement.h
index f37067df3455..3bdebc29accd 100644
--- a/MdePkg/Include/Protocol/FirmwareManagement.h
+++ b/MdePkg/Include/Protocol/FirmwareManagement.h
@@ -286,12 +286,12 @@ EFI_STATUS
The saved copy could later been used, for example, in firmware image recovery or rollback.
@param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance.
- @param[in, out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
+ @param[in,out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
On input, this is the size of the buffer allocated by the caller.
On output, it is the size of the buffer returned by the firmware
if the buffer was large enough, or the size of the buffer needed
to contain the image(s) information if the buffer was too small.
- @param[in, out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
+ @param[in,out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
information. The information is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs.
@param[out] DescriptorVersion A pointer to the location in which firmware returns the version number
associated with the EFI_FIRMWARE_IMAGE_DESCRIPTOR.
@@ -340,7 +340,7 @@ EFI_STATUS
@param[in] ImageIndex A unique number identifying the firmware image(s) within the device.
The number is between 1 and DescriptorCount.
@param[out] Image Points to the buffer where the current image is copied to.
- @param[in, out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
+ @param[in,out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
On return, points to the length of the image, in bytes.
@retval EFI_SUCCESS The device was successfully updated with the new image.
diff --git a/MdePkg/Include/Protocol/I2cEnumerate.h b/MdePkg/Include/Protocol/I2cEnumerate.h
index e1890e470c62..be07979043ae 100644
--- a/MdePkg/Include/Protocol/I2cEnumerate.h
+++ b/MdePkg/Include/Protocol/I2cEnumerate.h
@@ -28,7 +28,7 @@ typedef struct _EFI_I2C_ENUMERATE_PROTOCOL EFI_I2C_ENUMERATE_PROTOCOL;
@param[in] This The platform data for the next device on
the I2C bus was returned successfully.
- @param[in, out] Device Pointer to a buffer containing an
+ @param[in,out] Device Pointer to a buffer containing an
EFI_I2C_DEVICE structure. Enumeration is
started by setting the initial EFI_I2C_DEVICE
structure pointer to NULL. The buffer
diff --git a/MdePkg/Include/Protocol/IpSec.h b/MdePkg/Include/Protocol/IpSec.h
index 0b5d55a85293..6295bf43d401 100644
--- a/MdePkg/Include/Protocol/IpSec.h
+++ b/MdePkg/Include/Protocol/IpSec.h
@@ -55,11 +55,11 @@ typedef struct _EFI_IPSEC_FRAGMENT_DATA {
@param[in] This Pointer to the EFI_IPSEC_PROTOCOL instance.
@param[in] NicHandle Instance of the network interface.
@param[in] IpVer IPV4 or IPV6.
- @param[in, out] IpHead Pointer to the IP Header.
+ @param[in,out] IpHead Pointer to the IP Header.
@param[in] LastHead The protocol of the next layer to be processed by IPsec.
@param[in] OptionsBuffer Pointer to the options buffer.
@param[in] OptionsLength Length of the options buffer.
- @param[in, out] FragmentTable Pointer to a list of fragments.
+ @param[in,out] FragmentTable Pointer to a list of fragments.
@param[in] FragmentCount Number of fragments.
@param[in] TrafficDirection Traffic direction.
@param[out] RecycleSignal Event for recycling of resources.
@@ -111,7 +111,7 @@ struct _EFI_IPSEC_PROTOCOL {
@param[in] This Pointer to the EFI_IPSEC2_PROTOCOL instance.
@param[in] NicHandle Instance of the network interface.
@param[in] IpVer IP version.IPv4 or IPv6.
- @param[in, out] IpHead Pointer to the IP Header it is either
+ @param[in,out] IpHead Pointer to the IP Header it is either
the EFI_IP4_HEADER or EFI_IP6_HEADER.
On input, it contains the IP header.
On output, 1) in tunnel mode and the
@@ -123,10 +123,10 @@ struct _EFI_IPSEC_PROTOCOL {
mode, the related fielders (like payload
length, Next header) in IP header will
be modified according to the condition.
- @param[in, out] LastHead For IP4, it is the next protocol in IP
+ @param[in,out] LastHead For IP4, it is the next protocol in IP
header. For IP6 it is the Next Header
of the last extension header.
- @param[in, out] OptionsBuffer On input, it contains the options
+ @param[in,out] OptionsBuffer On input, it contains the options
(extensions header) to be processed by
IPsec. On output, 1) in tunnel mode and
the traffic direction is outbound, it
@@ -143,10 +143,10 @@ struct _EFI_IPSEC_PROTOCOL {
might be same with input's. The caller
should take the responsibility to free
the buffer both on input and on output.
- @param[in, out] OptionsLength On input, the input length of the options
+ @param[in,out] OptionsLength On input, the input length of the options
buffer. On output, the output length of
the options buffer.
- @param[in, out] FragmentTable Pointer to a list of fragments. On input,
+ @param[in,out] FragmentTable Pointer to a list of fragments. On input,
these fragments contain the IP payload.
On output, 1) in tunnel mode and the traffic
direction is inbound, the fragments contain
@@ -167,7 +167,7 @@ struct _EFI_IPSEC_PROTOCOL {
payload which encapsulates the next layer
protocol information between the encapsulated
header and encapsulated trailer fields.
- @param[in, out] FragmentCount Number of fragments.
+ @param[in,out] FragmentCount Number of fragments.
@param[in] TrafficDirection Traffic direction.
@param[out] RecycleSignal Event for recycling of resources.
diff --git a/MdePkg/Include/Protocol/IpSecConfig.h b/MdePkg/Include/Protocol/IpSecConfig.h
index 7136060691ca..2c9d3d8ddd45 100644
--- a/MdePkg/Include/Protocol/IpSecConfig.h
+++ b/MdePkg/Include/Protocol/IpSecConfig.h
@@ -647,7 +647,7 @@ EFI_STATUS
@param[in] DataType The type of data to retrieve.
@param[in] Selector Pointer to an entry selector which is an identifier of the IPsec
configuration data entry.
- @param[in, out] DataSize On output the size of data returned in Data.
+ @param[in,out] DataSize On output the size of data returned in Data.
@param[out] Data The buffer to return the contents of the IPsec configuration data.
The type of the data buffer is associated with the DataType.
@@ -692,8 +692,8 @@ EFI_STATUS
@param[in] This Pointer to the EFI_IPSEC_CONFIG_PROTOCOL instance.
@param[in] DataType The type of IPsec configuration data to retrieve.
- @param[in, out] SelectorSize The size of the Selector buffer.
- @param[in, out] Selector On input, supplies the pointer to last Selector that was
+ @param[in,out] SelectorSize The size of the Selector buffer.
+ @param[in,out] Selector On input, supplies the pointer to last Selector that was
returned by GetNextSelector().
On output, returns one copy of the current entry Selector
of a given DataType.
diff --git a/MdePkg/Include/Protocol/Kms.h b/MdePkg/Include/Protocol/Kms.h
index c37fcbb65c63..b63e7d2cbd1b 100644
--- a/MdePkg/Include/Protocol/Kms.h
+++ b/MdePkg/Include/Protocol/Kms.h
@@ -366,7 +366,7 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -379,7 +379,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -419,11 +419,11 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
+ @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
processed by this operation. On return, this number
will be updated with the number of key descriptors
successfully processed.
- @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
+ @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
structures which describe the keys to be generated.
On input, the KeyIdentifierSize and the KeyIdentifier
may specify an identifier to be used for the key,
@@ -447,7 +447,7 @@ EFI_STATUS
type and must be freed by the caller when it is no longer
needed. Also, the KeyStatus field must reflect the result
of the request relative to that key.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -460,7 +460,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -514,11 +514,11 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
+ @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
processed by this operation. On return, this number
will be updated with the number of key descriptors
successfully processed.
- @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
+ @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
structures which describe the keys to be retrieved
from the KMS.
On input, the KeyIdentifierSize and the KeyIdentifier
@@ -533,7 +533,7 @@ EFI_STATUS
must be freed by the caller when it is no longer needed.
Also, the KeyStatus field will reflect the result of the
request relative to the individual key descriptor.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -546,7 +546,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -602,11 +602,11 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
+ @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
processed by this operation. On normal return, this
number will be updated with the number of key
descriptors successfully processed.
- @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
+ @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
structures which describe the keys to be added.
On input, the KeyId field for first key must contain
valid identifier data to be used for adding a key to
@@ -619,7 +619,7 @@ EFI_STATUS
consistent values to be associated with the given KeyId.
On return, the KeyStatus field will reflect the result
of the operation for each key request.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -632,7 +632,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -688,11 +688,11 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
+ @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
processed by this operation. On normal return, this
number will be updated with the number of key
descriptors successfully processed.
- @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
+ @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
structures which describe the keys to be deleted.
On input, the KeyId field for first key must contain
valid identifier data to be used for adding a key to
@@ -704,7 +704,7 @@ EFI_STATUS
KeyValue fields are ignored, but should be 0.
On return, the KeyStatus field will reflect the result
of the operation for each key request.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -717,7 +717,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -770,19 +770,19 @@ EFI_STATUS
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
@param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
@param[in] KeyIdentifier Pointer to the key identifier associated with this key.
- @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
structures associated with the Key identifier. If none
are found, the count value is zero on return.
On input this value reflects the number of KeyAttributes
that may be returned.
On output, the value reflects the number of completed
KeyAttributes structures found.
- @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
structures associated with the Key Identifier.
On input, the fields in the structure should be NULL.
On output, the attribute fields will have updated values
for attributes associated with this key identifier.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -795,7 +795,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -858,18 +858,18 @@ EFI_STATUS
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
@param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
@param[in] KeyIdentifier Pointer to the key identifier associated with this key.
- @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
structures to associate with the Key. On normal returns,
this number will be updated with the number of key
attributes successfully processed.
- @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
structures providing the attribute information to
associate with the key.
On input, the values for the fields in the structure
are completely filled in.
On return the KeyAttributeStatus field will reflect the
result of the operation for each key attribute request.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -882,7 +882,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -948,19 +948,19 @@ EFI_STATUS
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
@param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
@param[in] KeyIdentifier Pointer to the key identifier associated with this key.
- @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
structures to associate with the Key.
On input, the count value is one or more.
On normal returns, this number will be updated with
the number of key attributes successfully processed.
- @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
structures providing the attribute information to
associate with the key.
On input, the values for the fields in the structure
are completely filled in.
On return the KeyAttributeStatus field will reflect the
result of the operation for each key attribute request.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -973,7 +973,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
@@ -1029,23 +1029,23 @@ EFI_STATUS
@param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
@param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
- @param[in, out] KeyAttributesCount Pointer to a count of the number of key attribute structures
+ @param[in,out] KeyAttributesCount Pointer to a count of the number of key attribute structures
that must be matched for each returned key descriptor.
On input the count value is one or more.
On normal returns, this number will be updated with
the number of key attributes successfully processed.
- @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
+ @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
structure to search for.
On input, the values for the fields in the structure are
completely filled in.
On return the KeyAttributeStatus field will reflect the
result of the operation for each key attribute request.
- @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
+ @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
by this operation.
On entry, this number will be zero.
On return, this number will be updated to the number
of key descriptors successfully found.
- @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
+ @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
structures which describe the keys from the KMS
having the KeyAttribute(s) specified.
On input, this pointer will be NULL.
@@ -1057,7 +1057,7 @@ EFI_STATUS
caller when it is no longer needed. Also, the KeyStatus
field of each descriptor will reflect the result of the
request relative to that key descriptor.
- @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
+ @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
data specified by the ClientData parameter. This
parameter may be NULL, in which case the ClientData
parameter will be ignored and no data will be
@@ -1070,7 +1070,7 @@ EFI_STATUS
In all cases, the value upon return to the caller will
be the size of the data block returned to the caller,
which will be zero if no data is returned from the KMS.
- @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
+ @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
*ClientDataSize that is to be passed directly to the
KMS if it supports the use of client data. This
parameter may be NULL if and only if the
diff --git a/MdePkg/Include/Protocol/MmCommunication2.h b/MdePkg/Include/Protocol/MmCommunication2.h
index 1b56320c7fff..86f74d9d2fa8 100644
--- a/MdePkg/Include/Protocol/MmCommunication2.h
+++ b/MdePkg/Include/Protocol/MmCommunication2.h
@@ -28,9 +28,9 @@ typedef struct _EFI_MM_COMMUNICATION2_PROTOCOL EFI_MM_COMMUNICATION2_PROTOCOL;
This function provides a service to send and receive messages from a registered UEFI service.
@param[in] This The EFI_MM_COMMUNICATION_PROTOCOL instance.
- @param[in, out] CommBufferPhysical Physical address of the MM communication buffer
- @param[in, out] CommBufferVirtual Virtual address of the MM communication buffer
- @param[in, out] CommSize The size of the data buffer being passed in. On exit, the
+ @param[in,out] CommBufferPhysical Physical address of the MM communication buffer
+ @param[in,out] CommBufferVirtual Virtual address of the MM communication buffer
+ @param[in,out] CommSize The size of the data buffer being passed in. On exit, the
size of data being returned. Zero if the handler does not
wish to reply with any data. This parameter is optional
and may be NULL.
diff --git a/MdePkg/Include/Protocol/MmSwDispatch.h b/MdePkg/Include/Protocol/MmSwDispatch.h
index e7810662ecdb..fdecac020e5e 100644
--- a/MdePkg/Include/Protocol/MmSwDispatch.h
+++ b/MdePkg/Include/Protocol/MmSwDispatch.h
@@ -62,7 +62,7 @@ typedef struct _EFI_MM_SW_DISPATCH_PROTOCOL EFI_MM_SW_DISPATCH_PROTOCOL;
@param[in] This Pointer to the EFI_MM_SW_DISPATCH_PROTOCOL instance.
@param[in] DispatchFunction Function to register for handler when the specified software
MMI is generated.
- @param[in, out] RegisterContext Pointer to the dispatch function's context.
+ @param[in,out] RegisterContext Pointer to the dispatch function's context.
The caller fills this context in before calling
the register function to indicate to the register
function which Software MMI input value the
diff --git a/MdePkg/Include/Protocol/Mtftp6.h b/MdePkg/Include/Protocol/Mtftp6.h
index 4abf296c1c01..ce5a1409c943 100644
--- a/MdePkg/Include/Protocol/Mtftp6.h
+++ b/MdePkg/Include/Protocol/Mtftp6.h
@@ -368,7 +368,7 @@ EFI_STATUS
@param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.
@param[in] Token The token provided in the EFI_MTFTP6_PROTOCOL.WriteFile() by the caller.
- @param[in, out] Length Indicates the length of the raw data wanted on input, and the
+ @param[in,out] Length Indicates the length of the raw data wanted on input, and the
length the data available on output.
@param[out] Buffer Pointer to the buffer where the data is stored.
diff --git a/MdePkg/Include/Protocol/Pcd.h b/MdePkg/Include/Protocol/Pcd.h
index 25f73cda1423..56c7f03e2c99 100644
--- a/MdePkg/Include/Protocol/Pcd.h
+++ b/MdePkg/Include/Protocol/Pcd.h
@@ -424,7 +424,7 @@ EFI_STATUS
If it is not, an error will be returned.
@param[in] TokenNumber The PCD token number.
- @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
+ @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
On input, if the SizeOfValue is greater than the maximum size supported
for this TokenNumber then the output value of SizeOfValue will reflect
the maximum size supported for this TokenNumber.
@@ -582,7 +582,7 @@ EFI_STATUS
@param[in] Guid The 128-bit unique value that designates the namespace from which to extract the value.
@param[in] TokenNumber The PCD token number.
- @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
+ @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
On input, if the SizeOfValue is greater than the maximum size supported
for this TokenNumber then the output value of SizeOfValue will reflect
the maximum size supported for this TokenNumber.
@@ -643,7 +643,7 @@ EFI_STATUS
@param[in] CallBackGuid The PCD token GUID being set.
@param[in] CallBackToken The PCD token number being set.
- @param[in, out] TokenData A pointer to the token data being set.
+ @param[in,out] TokenData A pointer to the token data being set.
@param[in] TokenDataSize The size, in bytes, of the data being set.
@retval VOID
@@ -737,7 +737,7 @@ EFI_STATUS
Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
token namespaces on a platform.
- @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
+ @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
from which the search will start. On output, it designates the next valid token
namespace on the platform. If *Guid is NULL, then the GUID of the first token
space of the current platform is returned. If the search cannot locate the next valid
diff --git a/MdePkg/Include/Protocol/PiPcd.h b/MdePkg/Include/Protocol/PiPcd.h
index e26733b5d9db..63b198c63e0e 100644
--- a/MdePkg/Include/Protocol/PiPcd.h
+++ b/MdePkg/Include/Protocol/PiPcd.h
@@ -379,7 +379,7 @@ EFI_STATUS
Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
token namespaces on a platform.
- @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
+ @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
from which the search will start. On output, it designates the next valid token
namespace on the platform. If *Guid is NULL, then the GUID of the first token
space of the current platform is returned. If the search cannot locate the next valid
diff --git a/MdePkg/Include/Protocol/S3SaveState.h b/MdePkg/Include/Protocol/S3SaveState.h
index c2b26944fb41..f9f45e0a115a 100644
--- a/MdePkg/Include/Protocol/S3SaveState.h
+++ b/MdePkg/Include/Protocol/S3SaveState.h
@@ -72,7 +72,7 @@ EFI_STATUS
in the boot script table specified by Position. If Position is NULL or points to
NULL then the new opcode is inserted at the beginning of the table (if TRUE) or end
of the table (if FALSE).
- @param[in, out] Position On entry, specifies the position in the boot script table where the opcode will be
+ @param[in,out] Position On entry, specifies the position in the boot script table where the opcode will be
inserted, either before or after, depending on BeforeOrAfter. On exit, specifies
the position of the inserted opcode in the boot script table.
@param[in] OpCode The operation code (opcode) number. See "Related Definitions" in Write() for the
@@ -111,7 +111,7 @@ EFI_STATUS
NULL then the new label is inserted at the beginning of the table (if TRUE) or end of
the table (if FALSE).
@param[in] CreateIfNotFound Specifies whether the label will be created if the label does not exists (TRUE) or not (FALSE).
- @param[in, out] Position On entry, specifies the position in the boot script table where the label will be inserted,
+ @param[in,out] Position On entry, specifies the position in the boot script table where the label will be inserted,
either before or after, depending on BeforeOrAfter. On exit, specifies the position
of the inserted label in the boot script table.
@param[in] Label Points to the label which will be inserted in the boot script table.
diff --git a/MdePkg/Include/Protocol/Shell.h b/MdePkg/Include/Protocol/Shell.h
index 5efee49e197a..413dd0e4acbb 100644
--- a/MdePkg/Include/Protocol/Shell.h
+++ b/MdePkg/Include/Protocol/Shell.h
@@ -734,7 +734,7 @@ EFI_STATUS
If there are multiple map names they will be semi-colon seperated in the
NULL-terminated string.
- @param[in, out] DevicePath On entry, points to a device path pointer. On
+ @param[in,out] DevicePath On entry, points to a device path pointer. On
exit, updates the pointer to point to the
portion of the device path after the mapping.
@@ -846,7 +846,7 @@ EFI_STATUS
@param[in] Path A pointer to the path string.
@param[in] OpenMode Specifies the mode used to open each file, EFI_FILE_MODE_READ or
EFI_FILE_MODE_WRITE.
- @param[in, out] FileList Points to the start of a list of files opened.
+ @param[in,out] FileList Points to the start of a list of files opened.
@retval EFI_SUCCESS Create the file list successfully.
@return Can't create the file list.
@@ -915,7 +915,7 @@ EFI_STATUS
@param[in] FileHandle The opened file handle for read.
@param[in] ReadSize On input, the size of Buffer, in bytes. On output, the amount of data read.
- @param[in, out] Buffer The buffer in which data is read.
+ @param[in,out] Buffer The buffer in which data is read.
@retval EFI_SUCCESS Data was read.
@retval EFI_NO_MEDIA The device has no media.
@@ -1157,7 +1157,7 @@ EFI_STATUS
Direct writes to opened directories are not supported.
@param[in] FileHandle The opened file handle for writing.
- @param[in, out] BufferSize On input, size of Buffer.
+ @param[in,out] BufferSize On input, size of Buffer.
@param[in] Buffer The buffer in which data to write.
@retval EFI_SUCCESS Data was written.
diff --git a/MdePkg/Include/Protocol/SmartCardEdge.h b/MdePkg/Include/Protocol/SmartCardEdge.h
index 1251680ec02f..2cf639a32633 100644
--- a/MdePkg/Include/Protocol/SmartCardEdge.h
+++ b/MdePkg/Include/Protocol/SmartCardEdge.h
@@ -225,13 +225,13 @@ extern EFI_GUID gEfiPaddingRsaesOaepGuid;
@param[in] This Indicates a pointer to the calling context.
@param[out] NumberAidSupported Number of AIDs this protocol supports.
- @param[in, out] AidTableSize On input, number of items allocated for the
+ @param[in,out] AidTableSize On input, number of items allocated for the
AID table. On output, number of items returned
by protocol.
@param[out] AidTable Table of the AIDs supported by the protocol.
@param[out] NumberSCPresent Number of currently present Smart Cards that
are supported by protocol.
- @param[in, out] CsnTableSize On input, the number of items the buffer CSN
+ @param[in,out] CsnTableSize On input, the number of items the buffer CSN
table can contain. On output, the number of
items returned by the protocol.
@param[out] CsnTable Table of the CSN of the Smart Card present and
@@ -343,7 +343,7 @@ EFI_STATUS
@param[in] This Indicates a pointer to the calling context.
@param[in] SCardHandle Handle on Smart Card connection.
- @param[in, out] ReaderNameLength On input, a pointer to the variable that holds
+ @param[in,out] ReaderNameLength On input, a pointer to the variable that holds
the maximal size, in bytes, of ReaderName.
On output, the required size, in bytes, for ReaderName.
@param[out] ReaderName A pointer to a NULL terminated string that will
@@ -455,7 +455,7 @@ EFI_STATUS
@param[in] This Indicates a pointer to the calling context.
@param[in] SCardHandle Handle on Smart Card connection.
@param[in] DataId The type identifier of the data to get.
- @param[in, out] DataSize On input, in bytes, the size of Data. On output,
+ @param[in,out] DataSize On input, in bytes, the size of Data. On output,
in bytes, the size of buffer required to store
the specified data.
@param[out] Data The data buffer in which the data is returned.
@@ -507,7 +507,7 @@ EFI_STATUS
@param[in] This Indicates a pointer to the calling context.
@param[in] SCardHandle Handle on Smart Card connection.
- @param[in, out] CredentialSize On input, in bytes, the size of buffer to store
+ @param[in,out] CredentialSize On input, in bytes, the size of buffer to store
the list of credential.
On output, in bytes, the size of buffer required
to store the entire list of credentials.
@@ -623,7 +623,7 @@ EFI_STATUS
- EFI_PADDING_RSAES_OAEP_GUID
@param[in] EncryptedSize Size of data to decrypt.
@param[in] EncryptedData Data to decrypt
- @param[in, out] PlaintextSize On input, in bytes, the size of buffer to store
+ @param[in,out] PlaintextSize On input, in bytes, the size of buffer to store
the decrypted data.
On output, in bytes, the size of buffer required
to store the decrypted data.
diff --git a/MdePkg/Include/Protocol/SmartCardReader.h b/MdePkg/Include/Protocol/SmartCardReader.h
index 0ce117c9c764..a65b40932ec5 100644
--- a/MdePkg/Include/Protocol/SmartCardReader.h
+++ b/MdePkg/Include/Protocol/SmartCardReader.h
@@ -135,13 +135,13 @@ EFI_STATUS
@param[in] This Indicates a pointer to the calling context.
@param[out] ReaderName A pointer to a NULL terminated string that will
contain the reader name.
- @param[in, out] ReaderNameLength On input, a pointer to the variablethat holds the
+ @param[in,out] ReaderNameLength On input, a pointer to the variablethat holds the
maximal size, in bytes,of ReaderName.
On output, the required size, in bytes, for ReaderName.
@param[out] State Current state of the smart card reader.
@param[out] CardProtocol Current protocol used to communicate with the smart card.
@param[out] Atr A pointer to retrieve the ATR of the smart card.
- @param[in, out] AtrLength On input, a pointer to hold the maximum size, in bytes,
+ @param[in,out] AtrLength On input, a pointer to hold the maximum size, in bytes,
of Atr(usually 33).
On output, the required size, inbytes, for the smart
card ATR.
@@ -184,7 +184,7 @@ EFI_STATUS
@param[in] CAPDULength Command APDU size, in bytes.
@param[out] RAPDU A pointer to a byte array that will contain the
Response APDU.
- @param[in, out] RAPDULength On input, the maximum size, inbytes, of the Response
+ @param[in,out] RAPDULength On input, the maximum size, inbytes, of the Response
APDU.
On output, the size, in bytes, of the Response APDU.
@@ -226,7 +226,7 @@ EFI_STATUS
@param[in] InBuffer A pointer to the input parameters.
@param[in] InBufferLength Size, in bytes, of input parameters.
@param[out] OutBuffer A pointer to the output parameters.
- @param[in, out] OutBufferLength On input, maximal size, in bytes, to store output
+ @param[in,out] OutBufferLength On input, maximal size, in bytes, to store output
parameters.
On output, the size, in bytes, of output parameters.
@@ -271,7 +271,7 @@ EFI_STATUS
@param[in] Attrib Identifier for the attribute to retrieve.
@param[out] OutBuffer A pointer to a buffer that will contain
attribute data.
- @param[in, out] OutBufferLength On input, maximal size, in bytes, to store
+ @param[in,out] OutBufferLength On input, maximal size, in bytes, to store
attribute data.
On output, the size, in bytes, of attribute
data.
diff --git a/MdePkg/Include/Protocol/Smbios.h b/MdePkg/Include/Protocol/Smbios.h
index f9346aac7224..83e8065f6fa3 100644
--- a/MdePkg/Include/Protocol/Smbios.h
+++ b/MdePkg/Include/Protocol/Smbios.h
@@ -97,7 +97,7 @@ typedef struct _EFI_SMBIOS_PROTOCOL EFI_SMBIOS_PROTOCOL;
@param[in] This The EFI_SMBIOS_PROTOCOL instance.
@param[in] ProducerHandle The handle of the controller or driver associated with the SMBIOS information. NULL means no handle.
- @param[in, out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique handle
+ @param[in,out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique handle
will be assigned to the SMBIOS record. If the SMBIOS handle is already in use,
EFI_ALREADY_STARTED is returned and the SMBIOS record is not updated.
@param[in] Record The data for the fixed portion of the SMBIOS record. The format of the record is
@@ -168,7 +168,7 @@ EFI_STATUS
only the SMBIOS records that match the optional Type argument.
@param[in] This The EFI_SMBIOS_PROTOCOL instance.
- @param[in, out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points to the
+ @param[in,out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points to the
next SMBIOS record handle. If it is FFFEh on entry, then the first SMBIOS record
handle will be returned. If it returns FFFEh on exit, then there are no more SMBIOS records.
@param[in] Type On entry, it points to the type of the next SMBIOS record to return. If NULL, it
diff --git a/MdePkg/Include/Protocol/SmmSwDispatch2.h b/MdePkg/Include/Protocol/SmmSwDispatch2.h
index d0db953f06b0..27e91b5fb80f 100644
--- a/MdePkg/Include/Protocol/SmmSwDispatch2.h
+++ b/MdePkg/Include/Protocol/SmmSwDispatch2.h
@@ -60,7 +60,7 @@ typedef struct _EFI_SMM_SW_DISPATCH2_PROTOCOL EFI_SMM_SW_DISPATCH2_PROTOCOL;
@param[in] This Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
@param[in] DispatchFunction Function to register for handler when the specified software
SMI is generated.
- @param[in, out] RegisterContext Pointer to the dispatch function's context.
+ @param[in,out] RegisterContext Pointer to the dispatch function's context.
The caller fills this context in before calling
the register function to indicate to the register
function which Software SMI input value the
diff --git a/MdePkg/Include/Protocol/SuperIo.h b/MdePkg/Include/Protocol/SuperIo.h
index 802615030c91..bc7655e27281 100644
--- a/MdePkg/Include/Protocol/SuperIo.h
+++ b/MdePkg/Include/Protocol/SuperIo.h
@@ -45,7 +45,7 @@ typedef struct _EFI_SIO_PROTOCOL EFI_SIO_PROTOCOL;
The Super I/O driver must track the current state of the Super I/O and enable the
configuration mode of Super I/O if necessary prior to register access.
@param[in] Register Register number.
- @param[in, out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to be
+ @param[in,out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to be
written to the Super I/O register. If Write is FALSE, Value is a pointer to the
destination buffer for the byte of data to be read from the Super I/O register.
diff --git a/MdePkg/Include/Protocol/Supplicant.h b/MdePkg/Include/Protocol/Supplicant.h
index d78622112583..0c44673482b5 100644
--- a/MdePkg/Include/Protocol/Supplicant.h
+++ b/MdePkg/Include/Protocol/Supplicant.h
@@ -311,7 +311,7 @@ typedef struct {
RequestBuffer is NULL.
@param[out] Buffer Pointer to the buffer to hold the built
packet.
- @param[in, out] BufferSize Pointer to the buffer size in bytes. On
+ @param[in,out] BufferSize Pointer to the buffer size in bytes. On
input, it is the buffer size provided by the
caller. On output, it is the buffer size in
fact needed to contain the packet.
@@ -347,7 +347,7 @@ EFI_STATUS
@param[in] This Pointer to the EFI_SUPPLICANT_PROTOCOL
instance.
- @param[in, out] FragmentTable Pointer to a list of fragment. The caller
+ @param[in,out] FragmentTable Pointer to a list of fragment. The caller
will take responsible to handle the original
FragmentTable while it may be reallocated in
Supplicant driver.
@@ -410,7 +410,7 @@ EFI_STATUS
@param[in] DataType The type of data.
@param[out] Data Pointer to the buffer to hold the data.
Ignored if DataSize is 0.
- @param[in, out] DataSize Pointer to the buffer size in bytes. On
+ @param[in,out] DataSize Pointer to the buffer size in bytes. On
input, it is the buffer size provided by the
caller. On output, it is the buffer size in
fact needed to contain the packet.
diff --git a/MdePkg/Include/Protocol/Tcg2Protocol.h b/MdePkg/Include/Protocol/Tcg2Protocol.h
index f1326a5ef022..7199b6407666 100644
--- a/MdePkg/Include/Protocol/Tcg2Protocol.h
+++ b/MdePkg/Include/Protocol/Tcg2Protocol.h
@@ -143,7 +143,7 @@ typedef struct tdEFI_TCG2_EVENT {
capability information and state information.
@param[in] This Indicates the calling context
- @param[in, out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
+ @param[in,out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
structure and sets the size field to the size of the structure allocated.
The callee fills in the fields with the EFI protocol capability information
and the current EFI TCG2 state information up to the number of fields which
diff --git a/MdePkg/Include/Protocol/Tls.h b/MdePkg/Include/Protocol/Tls.h
index edcf0e3e728c..24c902530b44 100644
--- a/MdePkg/Include/Protocol/Tls.h
+++ b/MdePkg/Include/Protocol/Tls.h
@@ -376,8 +376,8 @@ EFI_STATUS
@param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
@param[in] DataType TLS session data type.
- @param[in, out] Data Pointer to session data.
- @param[in, out] DataSize Total size of session data. On input, it means
+ @param[in,out] Data Pointer to session data.
+ @param[in,out] DataSize Total size of session data. On input, it means
the size of Data buffer. On output, it means the size
of copied Data buffer if EFI_SUCCESS, and means the
size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
@@ -422,7 +422,7 @@ EFI_STATUS
@param[in] RequestSize Packet size in bytes for the most recently received TLS
packet. 0 is only valid when RequestBuffer is NULL.
@param[out] Buffer Pointer to the buffer to hold the built packet.
- @param[in, out] BufferSize Pointer to the buffer size in bytes. On input, it is
+ @param[in,out] BufferSize Pointer to the buffer size in bytes. On input, it is
the buffer size provided by the caller. On output, it
is the buffer size in fact needed to contain the
packet.
@@ -456,7 +456,7 @@ EFI_STATUS
The ProcessPacket () function process each inbound or outbound TLS APP packet.
@param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
- @param[in, out] FragmentTable Pointer to a list of fragment. The caller will take
+ @param[in,out] FragmentTable Pointer to a list of fragment. The caller will take
responsible to handle the original FragmentTable while
it may be reallocated in TLS driver. If CryptMode is
EfiTlsEncrypt, on input these fragments contain the TLS
diff --git a/MdePkg/Include/Protocol/TlsConfig.h b/MdePkg/Include/Protocol/TlsConfig.h
index 8b2a94d41f8e..9b9019338757 100644
--- a/MdePkg/Include/Protocol/TlsConfig.h
+++ b/MdePkg/Include/Protocol/TlsConfig.h
@@ -87,8 +87,8 @@ EFI_STATUS
@param[in] This Pointer to the EFI_TLS_CONFIGURATION_PROTOCOL instance.
@param[in] DataType Configuration data type.
- @param[in, out] Data Pointer to configuration data.
- @param[in, out] DataSize Total size of configuration data. On input, it means
+ @param[in,out] Data Pointer to configuration data.
+ @param[in,out] DataSize Total size of configuration data. On input, it means
the size of Data buffer. On output, it means the size
of copied Data buffer if EFI_SUCCESS, and means the
size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
diff --git a/MdePkg/Include/Protocol/UfsDeviceConfig.h b/MdePkg/Include/Protocol/UfsDeviceConfig.h
index 34676c7831c5..ae0253ae4f64 100644
--- a/MdePkg/Include/Protocol/UfsDeviceConfig.h
+++ b/MdePkg/Include/Protocol/UfsDeviceConfig.h
@@ -34,8 +34,8 @@ typedef struct _EFI_UFS_DEVICE_CONFIG_PROTOCOL EFI_UFS_DEVICE_CONFIG_PROTOCOL;
@param[in] DescId The ID of device descriptor.
@param[in] Index The Index of device descriptor.
@param[in] Selector The Selector of device descriptor.
- @param[in, out] Descriptor The buffer of device descriptor to be read or written.
- @param[in, out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
+ @param[in,out] Descriptor The buffer of device descriptor to be read or written.
+ @param[in,out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
of the data buffer specified by Descriptor. On output, the number
of bytes that were actually transferred.
@@ -68,7 +68,7 @@ EFI_STATUS
@param[in] This The pointer to the EFI_UFS_DEVICE_CONFIG_PROTOCOL instance.
@param[in] Read The boolean variable to show r/w direction.
@param[in] FlagId The ID of flag to be read or written.
- @param[in, out] Flag The buffer to set or clear flag.
+ @param[in,out] Flag The buffer to set or clear flag.
@retval EFI_SUCCESS The flag descriptor is set/clear successfully.
@retval EFI_INVALID_PARAMETER This is NULL or Flag is NULL.
@@ -96,8 +96,8 @@ EFI_STATUS
@param[in] AttrId The ID of Attribute.
@param[in] Index The Index of Attribute.
@param[in] Selector The Selector of Attribute.
- @param[in, out] Attribute The buffer of Attribute to be read or written.
- @param[in, out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
+ @param[in,out] Attribute The buffer of Attribute to be read or written.
+ @param[in,out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
data buffer specified by Attribute. On output, the number of bytes
that were actually transferred.
diff --git a/MdePkg/Include/Protocol/UsbFunctionIo.h b/MdePkg/Include/Protocol/UsbFunctionIo.h
index e360b604808e..3b0fcba69806 100644
--- a/MdePkg/Include/Protocol/UsbFunctionIo.h
+++ b/MdePkg/Include/Protocol/UsbFunctionIo.h
@@ -343,7 +343,7 @@ EFI_STATUS
@param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
@param[in] EndpointIndex Indicates the endpoint.
@param[in] Direction Direction of the endpoint.
- @param[in, out] State Boolean, true value indicates that the endpoint
+ @param[in,out] State Boolean, true value indicates that the endpoint
is in a stalled state, false otherwise.
@retval EFI_SUCCESS The function returned successfully.
@@ -402,7 +402,7 @@ EFI_STATUS
@param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
@param[out] Message Indicates the event that initiated this notification.
- @param[in, out] PayloadSize On input, the size of the memory pointed by
+ @param[in,out] PayloadSize On input, the size of the memory pointed by
Payload. On output, the amount ofdata returned
in Payload.
@param[out] Payload A pointer to EFI_USBFN_MESSAGE_PAYLOAD instance
@@ -446,14 +446,14 @@ EFI_STATUS
@param[in] EndpointIndex Indicates the endpoint on which TX or RX transfer
needs to take place.
@param[in] Direction Direction of the endpoint.
- @param[in, out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
+ @param[in,out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
On input, the size of the Bufferin bytes.
On output, the amount of data returned in Buffer
in bytes.
If Direction is EfiUsbEndpointDirectionDeviceTx:
On input, the size of the Bufferin bytes.
On output, the amount of data transmitted in bytes.
- @param[in, out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
+ @param[in,out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
The Buffer to return the received data.
If Directionis EfiUsbEndpointDirectionDeviceTx:
The Buffer that contains the data to be transmitted.
@@ -630,9 +630,9 @@ EFI_STATUS
@param[in] Direction Direction of the endpoint.
@param[in] PolicyType Policy type the user is trying to retrieve for
the specified non-control endpoint.
- @param[in, out] BufferSize On input, the size of Bufferin bytes. On output,
+ @param[in,out] BufferSize On input, the size of Bufferin bytes. On output,
the amount of data returned in Bufferin bytes.
- @param[in, out] Buffer A pointer to a buffer to return requested endpoint
+ @param[in,out] Buffer A pointer to a buffer to return requested endpoint
policy value.
@retval EFI_SUCCESS The function returned successfully.
diff --git a/MdePkg/Include/Protocol/UserCredential.h b/MdePkg/Include/Protocol/UserCredential.h
index 986cf44994f1..d1d957330493 100644
--- a/MdePkg/Include/Protocol/UserCredential.h
+++ b/MdePkg/Include/Protocol/UserCredential.h
@@ -83,10 +83,10 @@ EFI_STATUS
by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
@param[in] This Points to this instance of the EFI_USER_CREDENTIAL_PROTOCOL.
- @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
+ @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
information will be returned. On exit, points to the width of the
bitmap returned.
- @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
+ @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
information will be returned. On exit, points to the height of the
bitmap returned
@param[out] Hii On return, holds the HII database handle.
diff --git a/MdePkg/Include/Protocol/UserCredential2.h b/MdePkg/Include/Protocol/UserCredential2.h
index fc64ba544a2b..caec534d61ef 100644
--- a/MdePkg/Include/Protocol/UserCredential2.h
+++ b/MdePkg/Include/Protocol/UserCredential2.h
@@ -81,10 +81,10 @@ EFI_STATUS
by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
@param[in] This Points to this instance of the EFI_USER_CREDENTIAL2_PROTOCOL.
- @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
+ @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
information will be returned. On exit, points to the width of the
bitmap returned.
- @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
+ @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
information will be returned. On exit, points to the height of the
bitmap returned
@param[out] Hii On return, holds the HII database handle.
diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h
index 7dfe35b4990b..516f4222d480 100644
--- a/MdePkg/Include/Uefi/UefiSpec.h
+++ b/MdePkg/Include/Uefi/UefiSpec.h
@@ -169,7 +169,7 @@ typedef struct {
0x80000000..0xFFFFFFFF are reserved for use by UEFI OS loaders
that are provided by operating system vendors.
@param[in] Pages The number of contiguous 4 KB pages to allocate.
- @param[in, out] Memory The pointer to a physical address. On input, the way in which the address is
+ @param[in,out] Memory The pointer to a physical address. On input, the way in which the address is
used depends on the value of Type.
@retval EFI_SUCCESS The requested pages were allocated.
@@ -214,7 +214,7 @@ EFI_STATUS
/**
Returns the current memory map.
- @param[in, out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
+ @param[in,out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
On input, this is the size of the buffer allocated by the caller.
On output, it is the size of the buffer returned by the firmware if
the buffer was large enough, or the size of the buffer needed to contain
@@ -391,7 +391,7 @@ EFI_STATUS
Determines the new virtual address that is to be used on subsequent memory accesses.
@param[in] DebugDisposition Supplies type information for the pointer being converted.
- @param[in, out] Address A pointer to a pointer that is to be fixed to be the value needed
+ @param[in,out] Address A pointer to a pointer that is to be fixed to be the value needed
for the new virtual address mappings being applied.
@retval EFI_SUCCESS The pointer pointed to by Address was modified.
@@ -650,7 +650,7 @@ VOID
@param[in] VendorGuid A unique identifier for the vendor.
@param[out] Attributes If not NULL, a pointer to the memory location to return the
attributes bitmask for the variable.
- @param[in, out] DataSize On input, the size in bytes of the return Data buffer.
+ @param[in,out] DataSize On input, the size in bytes of the return Data buffer.
On output the size of data returned in Data.
@param[out] Data The buffer to return the contents of the variable. May be NULL
with a zero DataSize in order to determine the size buffer needed.
@@ -679,12 +679,12 @@ EFI_STATUS
/**
Enumerates the current variable names.
- @param[in, out] VariableNameSize The size of the VariableName buffer. The size must be large
+ @param[in,out] VariableNameSize The size of the VariableName buffer. The size must be large
enough to fit input string supplied in VariableName buffer.
- @param[in, out] VariableName On input, supplies the last VariableName that was returned
+ @param[in,out] VariableName On input, supplies the last VariableName that was returned
by GetNextVariableName(). On output, returns the Nullterminated
string of the current variable.
- @param[in, out] VendorGuid On input, supplies the last VendorGuid that was returned by
+ @param[in,out] VendorGuid On input, supplies the last VendorGuid that was returned by
GetNextVariableName(). On output, returns the
VendorGuid of the current variable.
@@ -1155,7 +1155,7 @@ typedef enum {
InstallMultipleProtocolInterfaces() be used in place of
InstallProtocolInterface()
- @param[in, out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
+ @param[in,out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
@param[in] Protocol The numeric ID of the protocol interface.
@param[in] InterfaceType Indicates whether Interface is supplied in native form.
@param[in] Interface A pointer to the protocol interface.
@@ -1180,7 +1180,7 @@ EFI_STATUS
/**
Installs one or more protocol interfaces into the boot services environment.
- @param[in, out] Handle The pointer to a handle to install the new protocol interfaces on,
+ @param[in,out] Handle The pointer to a handle to install the new protocol interfaces on,
or a pointer to NULL if a new handle is to be allocated.
@param ... A variable argument list containing pairs of protocol GUIDs and protocol
interfaces.
@@ -1479,7 +1479,7 @@ typedef enum {
@param[in] SearchType Specifies which handle(s) are to be returned.
@param[in] Protocol Specifies the protocol to search by.
@param[in] SearchKey Specifies the search key.
- @param[in, out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
+ @param[in,out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
the array returned in Buffer (if the buffer was large enough) or the
size, in bytes, of the buffer needed to obtain the array (if the buffer was
not large enough).
@@ -1509,7 +1509,7 @@ EFI_STATUS
Locates the handle to a device on the device path that supports the specified protocol.
@param[in] Protocol Specifies the protocol to search for.
- @param[in, out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
+ @param[in,out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
path pointer is modified to point to the remaining part of the device
path.
@param[out] Device A pointer to the returned device handle.
--git a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
index e6f479b829f6..dfdee0b5d2c0 100644
--- a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
+++ b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
@@ -28,7 +28,7 @@ typedef struct {
the registered guid and Handler list. When it is initialized, it will be directly returned.
Or, HandlerInfo table will be initialized in this function.
- @param[in, out] InfoPointer The pointer to the handler information structure.
+ @param[in,out] InfoPointer The pointer to the handler information structure.
@retval RETURN_SUCCESS HandlerInfo table can be used to store guid and function tables.
@retval RETURN_OUT_OF_RESOURCES HandlerInfo table address is not writable.
diff --git a/MdePkg/Library/BaseLib/QuickSort.c b/MdePkg/Library/BaseLib/QuickSort.c
index d9f0e9a0f475..a7b7d0c6cd2b 100644
--- a/MdePkg/Library/BaseLib/QuickSort.c
+++ b/MdePkg/Library/BaseLib/QuickSort.c
@@ -22,7 +22,7 @@
if Count is < 2 then perform no action.
- @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
+ @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes
diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c b/MdePkg/Library/BasePcdLibNull/PcdLib.c
index a214371c3fdf..39303cf429a7 100644
--- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
+++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c
@@ -470,7 +470,7 @@ LibPcdSet64S (
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -645,7 +645,7 @@ LibPcdSetEx64S (
@param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -819,7 +819,7 @@ LibPcdGetNextTokenSpace (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer that was set.
@@ -870,7 +870,7 @@ LibPatchPcdSetPtr (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
@@ -923,7 +923,7 @@ LibPatchPcdSetPtrS (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@@ -979,7 +979,7 @@ LibPatchPcdSetPtrAndSize (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
diff --git a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
index 417096f33493..63339fb4a627 100644
--- a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
+++ b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
@@ -14,8 +14,8 @@
instruction sets.
@param[in] Reloc Pointer to the relocation record.
- @param[in, out] Fixup Pointer to the address to fix up.
- @param[in, out] FixupData Pointer to a buffer to log the fixups.
+ @param[in,out] Fixup Pointer to the address to fix up.
+ @param[in,out] FixupData Pointer to a buffer to log the fixups.
@param[in] Adjust The offset to adjust the fixup.
@return Status code.
@@ -117,8 +117,8 @@ PeCoffLoaderImageFormatSupported (
space for runtime calls.
@param[in] Reloc The pointer to the relocation record.
- @param[in, out] Fixup The pointer to the address to fix up.
- @param[in, out] FixupData The pointer to a buffer to log the fixups.
+ @param[in,out] Fixup The pointer to the address to fix up.
+ @param[in,out] FixupData The pointer to a buffer to log the fixups.
@param[in] Adjust The offset to adjust the fixup.
@return Status code.
diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c b/MdePkg/Library/DxePcdLib/DxePcdLib.c
index b2a8bf22a365..c371f26f24c1 100644
--- a/MdePkg/Library/DxePcdLib/DxePcdLib.c
+++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c
@@ -554,7 +554,7 @@ LibPcdSet64S (
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -731,7 +731,7 @@ LibPcdSetEx64S (
@param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -926,7 +926,7 @@ LibPcdGetNextTokenSpace (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@@ -977,7 +977,7 @@ LibPatchPcdSetPtr (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
@@ -1030,7 +1030,7 @@ LibPatchPcdSetPtrS (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@@ -1086,7 +1086,7 @@ LibPatchPcdSetPtrAndSize (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
--git a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
index c538f157a242..2436e2c8f62e 100644
--- a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
+++ b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
@@ -28,7 +28,7 @@ typedef struct {
Build guid hob for the global memory to store the registered guid and Handler list.
If GuidHob exists, HandlerInfo will be directly got from Guid hob data.
- @param[in, out] InfoPointer The pointer to pei handler information structure.
+ @param[in,out] InfoPointer The pointer to pei handler information structure.
@retval RETURN_SUCCESS Build Guid hob for the global memory space to store guid and function tables.
@retval RETURN_OUT_OF_RESOURCES No enough memory to allocated.
diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
index 166d4a6f32d0..f16c1f8715a0 100644
--- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
+++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
@@ -544,7 +544,7 @@ LibPcdSet64S (
If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -721,7 +721,7 @@ LibPcdSetEx64S (
@param[in] Guid Pointer to a 128-bit unique value that
designates which namespace to set a value from.
@param[in] TokenNumber The PCD token number to set a current value for.
- @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return The status of the set operation.
@@ -918,7 +918,7 @@ LibPcdGetNextTokenSpace (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@@ -969,7 +969,7 @@ LibPatchPcdSetPtr (
@param[out] PatchVariable A pointer to the global variable in a module that is
the target of the set operation.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
@@ -1022,7 +1022,7 @@ LibPatchPcdSetPtrS (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@@ -1078,7 +1078,7 @@ LibPatchPcdSetPtrAndSize (
the target of the set operation.
@param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
@param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
- @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
+ @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return The status of the set operation.
diff --git a/MdePkg/Library/SmmIoLib/SmmIoLib.c b/MdePkg/Library/SmmIoLib/SmmIoLib.c
index ad4bfff68c8a..070a0c4f7b2a 100644
--- a/MdePkg/Library/SmmIoLib/SmmIoLib.c
+++ b/MdePkg/Library/SmmIoLib/SmmIoLib.c
@@ -155,9 +155,9 @@ SmmIsMmioValid (
/**
Merge continuous entries whose type is EfiGcdMemoryTypeMemoryMappedIo.
- @param[in, out] GcdMemoryMap A pointer to the buffer in which firmware places
+ @param[in,out] GcdMemoryMap A pointer to the buffer in which firmware places
the current GCD memory map.
- @param[in, out] NumberOfDescriptors A pointer to the number of the
+ @param[in,out] NumberOfDescriptors A pointer to the number of the
GcdMemoryMap buffer. On input, this is the number of
the current GCD memory map. On output,
it is the number of new GCD memory map after merge.
diff --git a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
index ff143f00ab9a..1ba604b0cdda 100644
--- a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
+++ b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
@@ -723,7 +723,7 @@ PeriodicSmiDispatchFunctionOnCpu (
released to notify the CPU that is running the SMM Foundation that the periodic
SMI handler execution has finished its execution.
- @param[in, out] Buffer A pointer to the context for the periodic SMI handler.
+ @param[in,out] Buffer A pointer to the context for the periodic SMI handler.
**/
VOID
@@ -758,10 +758,10 @@ PeriodicSmiDispatchFunctionWithLock (
SmiHandlerRegister().
@param[in] Context Points to an optional handler context which was
specified when the handler was registered.
- @param[in, out] CommBuffer A pointer to a collection of data in memory that
+ @param[in,out] CommBuffer A pointer to a collection of data in memory that
will be conveyed from a non-SMM environment into
an SMM environment.
- @param[in, out] CommBufferSize The size of the CommBuffer.
+ @param[in,out] CommBufferSize The size of the CommBuffer.
@retval EFI_SUCCESS The interrupt was handled and quiesced.
No other handlers should still be called.
@@ -863,7 +863,7 @@ PeriodicSmiDispatchFunction (
/**
This function enables a periodic SMI handler.
- @param[in, out] DispatchHandle A pointer to the handle associated with the
+ @param[in,out] DispatchHandle A pointer to the handle associated with the
enabled periodic SMI handler. This is an
optional parameter that may be NULL. If it is
NULL, then the handle will not be returned,
diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
index 86678e965d99..8fe52cab316f 100644
--- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
+++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
@@ -697,8 +697,8 @@ FileHandleSetSize (
if Destination's current length (including NULL terminator) is already more then
CurrentSize, then ASSERT()
- @param[in, out] Destination The String to append onto
- @param[in, out] CurrentSize on call the number of bytes in Destination. On
+ @param[in,out] Destination The String to append onto
+ @param[in,out] CurrentSize on call the number of bytes in Destination. On
return possibly the new size (still in bytes). if NULL
then allocate whatever is needed.
@param[in] Source The String to append from
@@ -907,7 +907,7 @@ FileHandleGetFileName (
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from.
- @param[in, out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
+ @param[in,out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
@return The line of text from the file.
@@ -951,15 +951,15 @@ FileHandleReturnLine (
read a CHAR_NULL character will be returned in buffer.
@param[in] Handle FileHandle to read from.
- @param[in, out] Buffer The pointer to buffer to read into.
- @param[in, out] Size The pointer to number of bytes in Buffer.
+ @param[in,out] Buffer The pointer to buffer to read into.
+ @param[in,out] Size The pointer to number of bytes in Buffer.
@param[in] Truncate If the buffer is large enough, this has no effect.
If the buffer is is too small and Truncate is TRUE,
the line will be truncated.
If the buffer is is too small and Truncate is FALSE,
then no read will occur.
- @param[in, out] Ascii Boolean value for indicating whether the file is
+ @param[in,out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@retval EFI_SUCCESS The operation was successful. The line is stored in
diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
index a33cadd71646..af74ab732b21 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
@@ -81,12 +81,12 @@ typedef struct {
is greater than zero, then this function will return
EFI_TIMEOUT if the time required to execute the SCSI
Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated by
+ @param[in,out] SenseData A pointer to sense data that was generated by
the execution of the SCSI Request Packet. This
buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter is
optional and may be NULL.
- @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
+ @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
the SenseData buffer. On output, a pointer to
the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
@@ -199,12 +199,12 @@ ScsiTestUnitReadyCommand (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI
@@ -218,12 +218,12 @@ ScsiTestUnitReadyCommand (
See the EFI SCSI I/O Protocol in the UEFI
Specification for details on the possible
return values.
- @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
+ @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If InquiryDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
+ @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
of the InquiryDataBuffer buffer.
On output, a pointer to the number of bytes
written to the InquiryDataBuffer buffer.
@@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI
@@ -366,12 +366,12 @@ ScsiInquiryCommandEx (
See the EFI SCSI I/O Protocol in the UEFI
Specification for details on the possible
return values.
- @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
+ @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If InquiryDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
+ @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
of the InquiryDataBuffer buffer.
On output, a pointer to the number of bytes
written to the InquiryDataBuffer buffer.
@@ -464,12 +464,12 @@ ScsiInquiryCommand (
If Timeout is greater than zero, then this function
will return EFI_TIMEOUT if the time required to
execute the SCSI Request Packet is greater than Timeout.
- @param[in, out] SenseData A pointer to sense data that was generated
+ @param[in,out] SenseData A pointer to sense data that was generated
by the execution of the SCSI Request Packet.
This buffer must be allocated by the caller.
If SenseDataLength is 0, then this parameter
is optional and may be NULL.
- @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
+ @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
On output, the number of bytes written to the SenseData buffer.
@param[out] HostAdapterStatus The status of the SCSI Host Controller that
produces the SCSI bus containing the SCSI target
@@ -482,12 +482,12 @@ ScsiInquiryCommand (
on the SCSI Host Controller. See the EFI SCSI
I/O Protocol in the UEFI Specification for details
on the possible return values.
- @param[in, out] DataBuffer A pointer to data that was generated by the
+ @param[in,out] DataBuffer A pointer to data that was generated by the
execution of the SCSI Request Packet. This
buffer must be allocated by the caller. If
DataLength is 0, then this parameter is optional
and may be NULL.
- @param[in, out] DataLength On input, a pointer to the length in bytes of
+ @param[in,out] DataLength On input, a pointer to the length in bytes of
the DataBuffer buffer. On output, a pointer
to the number of bytes written to the DataBuffer
buffer.
@@ -602,8 +602,8 @@ ScsiModeSense10Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@@ -687,12 +687,12 @@ ScsiRequestSenseCommand (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] Pmi Partial medium indicator.
@retval EFI_SUCCESS Command is executed successfully.
@@ -790,12 +790,12 @@ ScsiReadCapacityCommand (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] Pmi Partial medium indicator.
@retval EFI_SUCCESS Command is executed successfully.
@@ -896,12 +896,12 @@ ScsiReadCapacity16Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 10 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 10 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -995,12 +995,12 @@ ScsiRead10Command (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -1095,12 +1095,12 @@ ScsiWrite10Command (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -1194,12 +1194,12 @@ ScsiRead16Command (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
@@ -1293,8 +1293,8 @@ ScsiWrite16Command (
@param[in] ScsiIo SCSI IO Protocol to use.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@param[in] SecurityProtocol The Security Protocol to use.
@@ -1302,7 +1302,7 @@ ScsiWrite16Command (
@param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
SECURITY PROTOCOL IN command.
@param[in] DataLength The size in bytes of the data buffer.
- @param[in, out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
@param[out] TransferLength A pointer to a buffer to store the size in
bytes of the data written to the data buffer.
@@ -1408,8 +1408,8 @@ ScsiSecurityProtocolInCommand (
@param[in] ScsiIo SCSI IO Protocol to use.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
@param[in] SecurityProtocol The Security Protocol to use.
@@ -1417,7 +1417,7 @@ ScsiSecurityProtocolInCommand (
@param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
SECURITY PROTOCOL OUT command.
@param[in] DataLength The size in bytes of the transfer data.
- @param[in, out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
@retval EFI_SUCCESS Command is executed successfully.
@retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
@@ -1573,12 +1573,12 @@ ScsiLibNotify (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -1756,12 +1756,12 @@ ScsiRead10CommandEx (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -1939,12 +1939,12 @@ ScsiWrite10CommandEx (
@param[in] ScsiIo A pointer to SCSI IO protocol.
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer Read 16 command data.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer Read 16 command data.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
@@ -2122,12 +2122,12 @@ ScsiRead16CommandEx (
@param[in] ScsiIo SCSI IO Protocol to use
@param[in] Timeout The length of timeout period.
- @param[in, out] SenseData A pointer to output sense data.
- @param[in, out] SenseDataLength The length of output sense data.
+ @param[in,out] SenseData A pointer to output sense data.
+ @param[in,out] SenseDataLength The length of output sense data.
@param[out] HostAdapterStatus The status of Host Adapter.
@param[out] TargetStatus The status of the target.
- @param[in, out] DataBuffer A pointer to a data buffer.
- @param[in, out] DataLength The length of data buffer.
+ @param[in,out] DataBuffer A pointer to a data buffer.
+ @param[in,out] DataLength The length of data buffer.
@param[in] StartLba The start address of LBA.
@param[in] SectorSize The number of contiguous logical blocks
of data that shall be transferred.
--
2.30.2
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-02-20 18:45 [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out] Rebecca Cran
@ 2023-02-21 1:58 ` Tinh Nguyen
2023-02-21 2:03 ` Rebecca Cran
2023-03-10 3:03 ` 回复: " gaoliming
2023-03-14 20:38 ` Michael D Kinney
2 siblings, 1 reply; 7+ messages in thread
From: Tinh Nguyen @ 2023-02-21 1:58 UTC (permalink / raw)
To: devel@edk2.groups.io, quic_rcran@quicinc.com
On 2/21/2023 1:45 AM, Rebecca Cran via groups.io wrote:
> There isn't supposed to be whitespace for "@param [in,out]" between "in"
> and "out". clang generates the following warning:
>
> test.c:8:9: warning: whitespace is not allowed in parameter passing direction [-Wdocumentation-pedantic]
> @param [in, out] argv Array of arguments.
> ^~~~~~~~~
> [in,out]
>
> Update the documentation blocks in MdePkg.
>
> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
> ---
>
Hi Rebecca,
It is just a personal question, not relevant to patch review, which tool
do you use?
Thanks,
Tinh
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-02-21 1:58 ` [edk2-devel] " Tinh Nguyen
@ 2023-02-21 2:03 ` Rebecca Cran
0 siblings, 0 replies; 7+ messages in thread
From: Rebecca Cran @ 2023-02-21 2:03 UTC (permalink / raw)
To: Tinh Nguyen OS, devel@edk2.groups.io, quic_rcran@quicinc.com
On 2/20/23 18:58, Tinh Nguyen OS wrote:
> On 2/21/2023 1:45 AM, Rebecca Cran via groups.io wrote:
>> There isn't supposed to be whitespace for "@param [in,out]" between "in"
>> and "out". clang generates the following warning:
>>
>> test.c:8:9: warning: whitespace is not allowed in parameter passing direction [-Wdocumentation-pedantic]
>> @param [in, out] argv Array of arguments.
>> ^~~~~~~~~
>> [in,out]
>>
>> Update the documentation blocks in MdePkg.
>>
>> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
>> ---
>>
> Hi Rebecca,
>
> It is just a personal question, not relevant to patch review, which tool
> do you use?
I used Visual Studio Code to do the search/replace.
--
Rebecca Cran
^ permalink raw reply [flat|nested] 7+ messages in thread
* 回复: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-02-20 18:45 [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out] Rebecca Cran
2023-02-21 1:58 ` [edk2-devel] " Tinh Nguyen
@ 2023-03-10 3:03 ` gaoliming
2023-03-14 18:06 ` Rebecca Cran
2023-03-14 20:38 ` Michael D Kinney
2 siblings, 1 reply; 7+ messages in thread
From: gaoliming @ 2023-03-10 3:03 UTC (permalink / raw)
To: devel, quic_rcran, 'Michael D Kinney',
'Zhiguang Liu'
Cc: 'Rebecca Cran'
Rebecca:
Does this change still follow DoxyGen format?
Thanks
Liming
> -----邮件原件-----
> 发件人: devel@edk2.groups.io <devel@edk2.groups.io> 代表 Rebecca Cran
> 发送时间: 2023年2月21日 2:46
> 收件人: devel@edk2.groups.io; Michael D Kinney
> <michael.d.kinney@intel.com>; Liming Gao <gaoliming@byosoft.com.cn>;
> Zhiguang Liu <zhiguang.liu@intel.com>
> 抄送: Rebecca Cran <rebecca@quicinc.com>
> 主题: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen
> param passing direction [in,out]
>
> There isn't supposed to be whitespace for "@param [in,out]" between "in"
> and "out". clang generates the following warning:
>
> test.c:8:9: warning: whitespace is not allowed in parameter passing
direction
> [-Wdocumentation-pedantic]
> @param [in, out] argv Array of arguments.
> ^~~~~~~~~
> [in,out]
>
> Update the documentation blocks in MdePkg.
>
> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
> ---
> MdePkg/Include/Library/BaseLib.h
> | 4 +-
> MdePkg/Include/Library/FileHandleLib.h
> | 12 +-
> MdePkg/Include/Library/PcdLib.h
> | 14 +--
> MdePkg/Include/Library/SmmPeriodicSmiLib.h
> | 2 +-
> MdePkg/Include/Library/UefiScsiLib.h
> | 124 ++++++++++----------
> MdePkg/Include/Ppi/CpuIo.h
> | 2 +-
> MdePkg/Include/Ppi/Graphics.h
> | 2 +-
> MdePkg/Include/Ppi/Pcd.h
> | 10 +-
> MdePkg/Include/Ppi/PiPcd.h
> | 2 +-
> MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> | 2 +-
> MdePkg/Include/Protocol/BlockIo2.h
> | 4 +-
> MdePkg/Include/Protocol/BlockIoCrypto.h
> | 6 +-
> MdePkg/Include/Protocol/BluetoothHc.h
> | 4 +-
> MdePkg/Include/Protocol/BluetoothIo.h
> | 4 +-
> MdePkg/Include/Protocol/BluetoothLeConfig.h
> | 10 +-
> MdePkg/Include/Protocol/CcMeasurement.h
> | 2 +-
> MdePkg/Include/Protocol/CpuIo2.h
> | 2 +-
> MdePkg/Include/Protocol/Eap.h
> | 2 +-
> MdePkg/Include/Protocol/EapConfiguration.h
> | 4 +-
> MdePkg/Include/Protocol/EapManagement.h
> | 2 +-
> MdePkg/Include/Protocol/EapManagement2.h
> | 8 +-
> MdePkg/Include/Protocol/EraseBlock.h
> | 2 +-
> MdePkg/Include/Protocol/FirmwareManagement.h
> | 6 +-
> MdePkg/Include/Protocol/I2cEnumerate.h
> | 2 +-
> MdePkg/Include/Protocol/IpSec.h
> | 16 +--
> MdePkg/Include/Protocol/IpSecConfig.h
> | 6 +-
> MdePkg/Include/Protocol/Kms.h
> | 72 ++++++------
> MdePkg/Include/Protocol/MmCommunication2.h
> | 6 +-
> MdePkg/Include/Protocol/MmSwDispatch.h
> | 2 +-
> MdePkg/Include/Protocol/Mtftp6.h
> | 2 +-
> MdePkg/Include/Protocol/Pcd.h
> | 8 +-
> MdePkg/Include/Protocol/PiPcd.h
> | 2 +-
> MdePkg/Include/Protocol/S3SaveState.h
> | 4 +-
> MdePkg/Include/Protocol/Shell.h
> | 8 +-
> MdePkg/Include/Protocol/SmartCardEdge.h
> | 12 +-
> MdePkg/Include/Protocol/SmartCardReader.h
> | 10 +-
> MdePkg/Include/Protocol/Smbios.h
> | 4 +-
> MdePkg/Include/Protocol/SmmSwDispatch2.h
> | 2 +-
> MdePkg/Include/Protocol/SuperIo.h
> | 2 +-
> MdePkg/Include/Protocol/Supplicant.h
> | 6 +-
> MdePkg/Include/Protocol/Tcg2Protocol.h
> | 2 +-
> MdePkg/Include/Protocol/Tls.h
> | 8 +-
> MdePkg/Include/Protocol/TlsConfig.h
> | 4 +-
> MdePkg/Include/Protocol/UfsDeviceConfig.h
> | 10 +-
> MdePkg/Include/Protocol/UsbFunctionIo.h
> | 12 +-
> MdePkg/Include/Protocol/UserCredential.h
> | 4 +-
> MdePkg/Include/Protocol/UserCredential2.h
> | 4 +-
> MdePkg/Include/Uefi/UefiSpec.h
> | 22 ++--
>
> MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.
> c | 2 +-
> MdePkg/Library/BaseLib/QuickSort.c
> | 2 +-
> MdePkg/Library/BasePcdLibNull/PcdLib.c
> | 12 +-
> MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> | 8 +-
> MdePkg/Library/DxePcdLib/DxePcdLib.c
> | 12 +-
> MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> | 2 +-
> MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> | 12 +-
> MdePkg/Library/SmmIoLib/SmmIoLib.c
> | 4 +-
> MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> | 8 +-
> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> | 12 +-
> MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> | 124 ++++++++++----------
> 59 files changed, 329 insertions(+), 329 deletions(-)
>
> diff --git a/MdePkg/Include/Library/BaseLib.h
> b/MdePkg/Include/Library/BaseLib.h
> index 8f2df76c29a3..0dee0f58aa75 100644
> --- a/MdePkg/Include/Library/BaseLib.h
> +++ b/MdePkg/Include/Library/BaseLib.h
> @@ -2482,7 +2482,7 @@ BcdToDecimal8 (
> /**
> Removes the last directory or file entry in a path.
>
> - @param[in, out] Path The pointer to the path to modify.
> + @param[in,out] Path The pointer to the path to modify.
>
> @retval FALSE Nothing was found to remove.
> @retval TRUE A directory or file was removed.
> @@ -2930,7 +2930,7 @@ INTN
>
> if Count is < 2 then perform no action.
>
> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted)
> elements
> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted)
> elements
> on return a buffer of sorted
> elements
> @param[in] Count the number of elements in the
> buffer to sort
> @param[in] ElementSize Size of an element in bytes
> diff --git a/MdePkg/Include/Library/FileHandleLib.h
> b/MdePkg/Include/Library/FileHandleLib.h
> index 1a238edee38c..2ea97c317c27 100644
> --- a/MdePkg/Include/Library/FileHandleLib.h
> +++ b/MdePkg/Include/Library/FileHandleLib.h
> @@ -78,7 +78,7 @@ FileHandleSetInfo (
> EFI_FILE_INFO is the structure returned as the directory entry.
>
> @param[in] FileHandle The opened file handle.
> - @param[in, out] BufferSize On input, the size of buffer in bytes.
On
> return,
> + @param[in,out] BufferSize On input, the size of buffer in bytes.
> On return,
> the number of bytes written.
> @param[out] Buffer The buffer to put read data into.
>
> @@ -109,7 +109,7 @@ FileHandleRead (
> opened directories are not supported.
>
> @param[in] FileHandle The opened file for writing.
> - @param[in, out] BufferSize On input, the number of bytes in Buffer.
> On output,
> + @param[in,out] BufferSize On input, the number of bytes in Buffer.
> On output,
> the number of bytes written.
> @param[in] Buffer The buffer containing data to write is
> stored.
>
> @@ -381,15 +381,15 @@ FileHandleGetFileName (
> read a CHAR_NULL character will be returned in buffer.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Buffer The pointer to buffer to read into.
> - @param[in, out] Size The pointer to number of bytes in
> Buffer.
> + @param[in,out] Buffer The pointer to buffer to read into.
> + @param[in,out] Size The pointer to number of bytes in
> Buffer.
> @param[in] Truncate If the buffer is large enough, this has
> no effect.
> If the buffer is is too small and
> Truncate is TRUE,
> the line will be truncated.
> If the buffer is is too small and
> Truncate is FALSE,
> then no read will occur.
>
> - @param[in, out] Ascii Boolean value for indicating whether
> the file is
> + @param[in,out] Ascii Boolean value for indicating whether
> the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @retval EFI_SUCCESS The operation was successful. The
> line is stored in
> @@ -418,7 +418,7 @@ FileHandleReadLine (
> maintained and not changed for all operations with the same file.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Ascii Boolean value for indicating whether
> the file is
> + @param[in,out] Ascii Boolean value for indicating whether
> the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @return The line of text from the file.
> diff --git a/MdePkg/Include/Library/PcdLib.h
> b/MdePkg/Include/Library/PcdLib.h
> index 4b103f0753c5..86739a3b2bd1 100644
> --- a/MdePkg/Include/Library/PcdLib.h
> +++ b/MdePkg/Include/Library/PcdLib.h
> @@ -1158,7 +1158,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -1303,7 +1303,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set
> a value from.
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -1354,7 +1354,7 @@ LibPcdSetExBoolS (
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being
> set.
> @param[in] TokenDataSize The size, in bytes, of the data being
> set.
>
> **/
> @@ -1474,7 +1474,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the Buffer that was set.
> @@ -1506,7 +1506,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> @@ -1540,7 +1540,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the Buffer that was set.
> @@ -1575,7 +1575,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> index 83d9bdde0eb8..dd3745d65af8 100644
> --- a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> +++ b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> @@ -104,7 +104,7 @@ VOID
> /**
> This function enables a periodic SMI handler.
>
> - @param[in, out] DispatchHandle A pointer to the handle associated
> with the
> + @param[in,out] DispatchHandle A pointer to the handle associated
> with the
> enabled periodic SMI handler.
> This is an
> optional parameter that may be
> NULL. If it is
> NULL, then the handle will not
> be returned,
> diff --git a/MdePkg/Include/Library/UefiScsiLib.h
> b/MdePkg/Include/Library/UefiScsiLib.h
> index da6ac2df68e7..90db37456ad2 100644
> --- a/MdePkg/Include/Library/UefiScsiLib.h
> +++ b/MdePkg/Include/Library/UefiScsiLib.h
> @@ -39,12 +39,12 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
> is greater than zero, then this
> function will return
> EFI_TIMEOUT if the time
> required to execute the SCSI
> Request Packet is greater than
> Timeout.
> - @param[in, out] SenseData A pointer to sense data that was
> generated by
> + @param[in,out] SenseData A pointer to sense data that was
> generated by
> the execution of the SCSI
> Request Packet. This
> buffer must be allocated by the
> caller.
> If SenseDataLength is 0, then
> this parameter is
> optional and may be NULL.
> - @param[in, out] SenseDataLength On input, a pointer to the length in
> bytes of
> + @param[in,out] SenseDataLength On input, a pointer to the length in
> bytes of
> the SenseData buffer. On
> output, a pointer to
> the number of bytes written to
> the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that produces
> @@ -122,12 +122,12 @@ ScsiTestUnitReadyCommand (
> If Timeout is greater than
> zero, then this function
> will return EFI_TIMEOUT
> if the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that
> was generated
> + @param[in,out] SenseData A pointer to sense data
> that was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If SenseDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI
> @@ -141,12 +141,12 @@ ScsiTestUnitReadyCommand (
> See the EFI SCSI I/O
> Protocol in the UEFI
> Specification for details
> on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If InquiryDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the
> length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the
> length in bytes
> of the InquiryDataBuffer
> buffer.
> On output, a pointer to
> the number of bytes
> written to the
> InquiryDataBuffer buffer.
> @@ -223,12 +223,12 @@ ScsiInquiryCommand (
> If Timeout is greater than
> zero, then this function
> will return EFI_TIMEOUT
> if the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that
> was generated
> + @param[in,out] SenseData A pointer to sense data
> that was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If SenseDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI
> @@ -242,12 +242,12 @@ ScsiInquiryCommand (
> See the EFI SCSI I/O
> Protocol in the UEFI
> Specification for details
> on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If InquiryDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the
> length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the
> length in bytes
> of the InquiryDataBuffer
> buffer.
> On output, a pointer to
> the number of bytes
> written to the
> InquiryDataBuffer buffer.
> @@ -329,12 +329,12 @@ ScsiInquiryCommandEx (
> If Timeout is greater than zero,
> then this function
> will return EFI_TIMEOUT if
> the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was
> generated
> + @param[in,out] SenseData A pointer to sense data that was
> generated
> by the execution of the SCSI
> Request Packet.
> This buffer must be allocated
> by the caller.
> If SenseDataLength is 0, then
> this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of
> the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of
> the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI target
> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
> on the SCSI Host Controller.
> See the EFI SCSI
> I/O Protocol in the UEFI
> Specification for details
> on the possible return values.
> - @param[in, out] DataBuffer A pointer to data that was
> generated by the
> + @param[in,out] DataBuffer A pointer to data that was
> generated by the
> execution of the SCSI Request
> Packet. This
> buffer must be allocated by
> the caller. If
> DataLength is 0, then this
> parameter is optional
> and may be NULL.
> - @param[in, out] DataLength On input, a pointer to the length
> in bytes of
> + @param[in,out] DataLength On input, a pointer to the length
> in bytes of
> the DataBuffer buffer. On
> output, a pointer
> to the number of bytes
> written to the DataBuffer
> buffer.
> @@ -420,8 +420,8 @@ ScsiModeSense10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO
> protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output sense
> data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
>
> @@ -469,12 +469,12 @@ ScsiRequestSenseCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @@ -527,12 +527,12 @@ ScsiReadCapacityCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @@ -586,12 +586,12 @@ ScsiReadCapacity16Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 10 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 10 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -646,12 +646,12 @@ ScsiRead10Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -706,12 +706,12 @@ ScsiWrite10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -766,12 +766,12 @@ ScsiRead16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -825,8 +825,8 @@ ScsiWrite16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output
> sense data.
> + @param[in,out] SenseData A pointer to output
> sense data.
> + @param[in,out] SenseDataLength The length of output
> sense data.
> @param[out] HostAdapterStatus The status of Host
> Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to
> use.
> @@ -834,7 +834,7 @@ ScsiWrite16Command (
> @param[in] Inc512 If TRUE, 512
> increment (INC_512) bit will be set for the
> SECURITY PROTOCOL
> IN command.
> @param[in] DataLength The size in bytes of the
> data buffer.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data
> buffer.
> @param[out] TransferLength A pointer to a buffer to
> store the size in
> bytes of the data
> written to the data buffer.
>
> @@ -889,8 +889,8 @@ ScsiSecurityProtocolInCommand (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output
> sense data.
> + @param[in,out] SenseData A pointer to output
> sense data.
> + @param[in,out] SenseDataLength The length of output
> sense data.
> @param[out] HostAdapterStatus The status of Host
> Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to
> use.
> @@ -898,7 +898,7 @@ ScsiSecurityProtocolInCommand (
> @param[in] Inc512 If TRUE, 512
> increment (INC_512) bit will be set for the
> SECURITY PROTOCOL
> OUT command.
> @param[in] DataLength The size in bytes of the
> transfer data.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data
> buffer.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was
> executed, but the entire DataBuffer could
> @@ -960,12 +960,12 @@ ScsiSecurityProtocolOutCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -1049,12 +1049,12 @@ ScsiRead10CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -1138,12 +1138,12 @@ ScsiWrite10CommandEx (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -1227,12 +1227,12 @@ ScsiRead16CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
> index 193a78e3c256..5e2ca4edbc22 100644
> --- a/MdePkg/Include/Ppi/CpuIo.h
> +++ b/MdePkg/Include/Ppi/CpuIo.h
> @@ -46,7 +46,7 @@ typedef enum {
> @param[in] Width The width of the access. Enumerated
> in bytes.
> @param[in] Address The physical address of the access.
> @param[in] Count The number of accesses to perform.
> - @param[in, out] Buffer A pointer to the buffer of data.
> + @param[in,out] Buffer A pointer to the buffer of data.
>
> @retval EFI_SUCCESS The function completed successfully.
> @retval EFI_NOT_YET_AVAILABLE The service has not been installed.
> diff --git a/MdePkg/Include/Ppi/Graphics.h b/MdePkg/Include/Ppi/Graphics.h
> index 3854f6c371c2..e8c1bc14b0ac 100644
> --- a/MdePkg/Include/Ppi/Graphics.h
> +++ b/MdePkg/Include/Ppi/Graphics.h
> @@ -48,7 +48,7 @@ EFI_STATUS
> The GraphicsPpiGetMode returns the mode information supported by the
> Graphics PEI
> Module.
>
> - @param[in, out] Mode Pointer to
> EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
> + @param[in,out] Mode Pointer to
> EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>
> @retval EFI_SUCCESS Valid mode information was
> returned.
> @retval EFI_INVALID_PARAMETER The Mode parameter is not valid.
> diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
> index d36a7f106cc8..3e6556314d1b 100644
> --- a/MdePkg/Include/Ppi/Pcd.h
> +++ b/MdePkg/Include/Ppi/Pcd.h
> @@ -420,7 +420,7 @@ EFI_STATUS
> If it is not, an error will be returned.
>
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfValue A pointer to the length of the value being
> set for the PCD token.
> + @param[in,out] SizeOfValue A pointer to the length of the value being
> set for the PCD token.
> On input, if the SizeOfValue is greater
> than the maximum size supported
> for this TokenNumber then the output
> value of SizeOfValue will reflect
> the maximum size supported for this
> TokenNumber.
> @@ -578,7 +578,7 @@ EFI_STATUS
>
> @param[in] Guid The 128-bit unique value that
> designates the namespace from which to extract the value.
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfValue A pointer to the length of the value being
> set for the PCD token.
> + @param[in,out] SizeOfValue A pointer to the length of the value being
> set for the PCD token.
> On input, if the SizeOfValue is greater
> than the maximum size supported
> for this TokenNumber then the output
> value of SizeOfValue will reflect
> the maximum size supported for this
> TokenNumber.
> @@ -638,7 +638,7 @@ EFI_STATUS
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being set.
> @param[in] TokenDataSize The size, in bytes, of the data being
set.
>
> @retval VOID
> @@ -712,7 +712,7 @@ EFI_STATUS
> @param[in] Guid The 128-bit unique value that
> designates the namespace from which to extract the value.
> This is an optional parameter that
> may be NULL. If this parameter is NULL, then a request
> is being made to retrieve tokens from
> the default token space.
> - @param[in, out] TokenNumber A pointer to the PCD token number to
> use to find the subsequent token number.
> + @param[in,out] TokenNumber A pointer to the PCD token number to
> use to find the subsequent token number.
>
> @retval EFI_SUCCESS The PCD service has retrieved the next valid
> token number.
> @retval EFI_NOT_FOUND The PCD service could not find data from the
> requested token number.
> @@ -731,7 +731,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is
useful
> to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token
> namespace from which the search will
> start. On output, it designates the next valid
> token namespace on the platform. If
> *Guid is NULL, then the GUID of the first token
> space of the current platform is returned.
> If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
> index 8d0f95eb27cc..8b137f2ca9e2 100644
> --- a/MdePkg/Include/Ppi/PiPcd.h
> +++ b/MdePkg/Include/Ppi/PiPcd.h
> @@ -387,7 +387,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is
useful
> to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token
> namespace from which the search will
> start. On output, it designates the next valid
> token namespace on the platform. If
> *Guid is NULL, then the GUID of the first token
> space of the current platform is returned.
> If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> index 9e134200da54..f25c3a7cd641 100644
> --- a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> +++ b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> @@ -162,7 +162,7 @@ EFI_STATUS
> Return the child ACPI objects.
>
> @param[in] ParentHandle Parent handle.
> - @param[in, out] Handle On entry, points to the previously
> returned handle or NULL to start with the first
> + @param[in,out] Handle On entry, points to the previously
> returned handle or NULL to start with the first
> handle. On return, points to the
> next returned ACPI handle or NULL if there are no
> child objects.
>
> diff --git a/MdePkg/Include/Protocol/BlockIo2.h
> b/MdePkg/Include/Protocol/BlockIo2.h
> index d25f51f73354..9bd5e7a6ddd9 100644
> --- a/MdePkg/Include/Protocol/BlockIo2.h
> +++ b/MdePkg/Include/Protocol/BlockIo2.h
> @@ -72,7 +72,7 @@ EFI_STATUS
> @param[in] MediaId Id of the media, changes every time the
> media is
> replaced.
> @param[in] Lba The starting Logical Block Address to
> read from.
> - @param[in, out] Token A pointer to the token associated with the
> transaction.
> + @param[in,out] Token A pointer to the token associated with
> the transaction.
> @param[in] BufferSize Size of Buffer, must be a multiple of
device
> block size.
> @param[out] Buffer A pointer to the destination buffer for
> the data. The
> caller is responsible for either having
> implicit or
> @@ -116,7 +116,7 @@ EFI_STATUS
> @param[in] Lba The starting logical block address to be
> written. The
> caller is responsible for writing to only
> legitimate
> locations.
> - @param[in, out] Token A pointer to the token associated with the
> transaction.
> + @param[in,out] Token A pointer to the token associated with
> the transaction.
> @param[in] BufferSize Size of Buffer, must be a multiple of
device
> block size.
> @param[in] Buffer A pointer to the source buffer for the
> data.
>
> diff --git a/MdePkg/Include/Protocol/BlockIoCrypto.h
> b/MdePkg/Include/Protocol/BlockIoCrypto.h
> index bcc0ed40beff..f15cde32f61b 100644
> --- a/MdePkg/Include/Protocol/BlockIoCrypto.h
> +++ b/MdePkg/Include/Protocol/BlockIoCrypto.h
> @@ -356,7 +356,7 @@ EFI_STATUS
> @param[in] MediaId The media ID that the read request is
> for.
> @param[in] LBA The starting logical block address to
> read from on
> the device.
> - @param[in, out] Token A pointer to the token associated with
> the transaction.
> + @param[in,out] Token A pointer to the token associated with
> the transaction.
> @param[in] BufferSize The size of the Buffer in bytes. This
> must be a multiple
> of the intrinsic block size of the
> device.
> @param[out] Buffer A pointer to the destination buffer for
> the data. The
> @@ -423,7 +423,7 @@ EFI_STATUS
> @param[in] MediaId The media ID that the read request is
> for.
> @param[in] LBA The starting logical block address to
> read from on
> the device.
> - @param[in, out] Token A pointer to the token associated with
> the transaction.
> + @param[in,out] Token A pointer to the token associated with
> the transaction.
> @param[in] BufferSize The size of the Buffer in bytes. This
> must be a multiple
> of the intrinsic block size of the
> device.
> @param[in] Buffer A pointer to the source buffer for the
> data.
> @@ -482,7 +482,7 @@ EFI_STATUS
> will not be signaled.
>
> @param[in] This Pointer to the
> EFI_BLOCK_IO_CRYPTO_PROTOCOL instance.
> - @param[in, out] Token A pointer to the token associated with
> the transaction.
> + @param[in,out] Token A pointer to the token associated with
> the transaction.
>
> @retval EFI_SUCCESS The flush request was queued if Event
> is not NULL. All
> outstanding data was written
> correctly to the device if
> diff --git a/MdePkg/Include/Protocol/BluetoothHc.h
> b/MdePkg/Include/Protocol/BluetoothHc.h
> index d75cb08f8928..29faf36fb7b7 100644
> --- a/MdePkg/Include/Protocol/BluetoothHc.h
> +++ b/MdePkg/Include/Protocol/BluetoothHc.h
> @@ -164,7 +164,7 @@ EFI_STATUS
> capability.
>
> @param[in] This Pointer to the
> EFI_BLUETOOTH_HC_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in
bytes,
> of the data buffer
> + @param[in,out] BufferSize On input, indicates the size, in
bytes,
> of the data buffer
> specified by Buffer. On output,
> indicates the amount of
> data actually transferred.
> @param[in] Buffer A pointer to the buffer of data
> that will be transmitted to
> @@ -200,7 +200,7 @@ EFI_STATUS
> ACL data packet, including Handle, PB flag, BC flag, data length, and
data.
>
> @param[in] This Pointer to the
> EFI_BLUETOOTH_HC_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in
bytes,
> of the data buffer
> + @param[in,out] BufferSize On input, indicates the size, in
bytes,
> of the data buffer
> specified by Buffer. On output,
> indicates the amount of
> data actually transferred.
> @param[out] Buffer A pointer to the buffer of data
> that will be received from
> diff --git a/MdePkg/Include/Protocol/BluetoothIo.h
> b/MdePkg/Include/Protocol/BluetoothIo.h
> index 620bfbc961cc..b4f6aee73e55 100644
> --- a/MdePkg/Include/Protocol/BluetoothIo.h
> +++ b/MdePkg/Include/Protocol/BluetoothIo.h
> @@ -105,7 +105,7 @@ EFI_STATUS
> Send L2CAP message (including L2CAP header).
>
> @param[in] This Pointer to the
> EFI_BLUETOOTH_IO_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in bytes,
of
> the data buffer specified by Buffer.
> + @param[in,out] BufferSize On input, indicates the size, in bytes,
> of the data buffer specified by Buffer.
> On output, indicates the amount
> of data actually transferred.
> @param[in] Buffer A pointer to the buffer of data that
> will be transmitted to Bluetooth L2CAP layer.
> @param[in] Timeout Indicating the transfer should be
> completed within this time frame. The units are in
> @@ -212,7 +212,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_BLUETOOTH_IO_PROTOCOL instance.
> @param[in] Handle A handle created by
> EFI_BLUETOOTH_IO_PROTOCOL.L2CapConnect indicates which channel to
> send.
> - @param[in, out] BufferSize On input, indicates the size, in bytes,
of
> the data buffer specified by Buffer.
> + @param[in,out] BufferSize On input, indicates the size, in bytes,
> of the data buffer specified by Buffer.
> On output, indicates the amount
> of data actually transferred.
> @param[in] Buffer A pointer to the buffer of data that
> will be transmitted to Bluetooth L2CAP layer.
> @param[in] Timeout Indicating the transfer should be
> completed within this time frame. The units are in
> diff --git a/MdePkg/Include/Protocol/BluetoothLeConfig.h
> b/MdePkg/Include/Protocol/BluetoothLeConfig.h
> index 6331e60a8655..2ec8a48fc551 100644
> --- a/MdePkg/Include/Protocol/BluetoothLeConfig.h
> +++ b/MdePkg/Include/Protocol/BluetoothLeConfig.h
> @@ -234,9 +234,9 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> - @param[in, out] DataSize On input, indicates the size, in bytes,
of
> the data buffer specified by Data.
> + @param[in,out] DataSize On input, indicates the size, in bytes,
of
> the data buffer specified by Data.
> On output, indicates the amount of
> data actually returned.
> - @param[in, out] Data A pointer to the buffer of data that will
> be returned.
> + @param[in,out] Data A pointer to the buffer of data that will
> be returned.
>
> @retval EFI_SUCCESS The BluetoothLE configuration data is
> returned successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following
> conditions is TRUE:
> @@ -293,9 +293,9 @@ EFI_STATUS
> @param[in] This Pointer to the
> EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> @param[in] BDAddr Remote BluetoothLE device address.
> - @param[in, out] DataSize On input, indicates the size, in bytes,
of
> the data buffer specified by Data.
> + @param[in,out] DataSize On input, indicates the size, in bytes,
of
> the data buffer specified by Data.
> On output, indicates the amount of
> data actually returned.
> - @param[in, out] Data A pointer to the buffer of data that will
> be returned.
> + @param[in,out] Data A pointer to the buffer of data that will
> be returned.
>
> @retval EFI_SUCCESS The remote BluetoothLE device
> configuration data is returned successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following
> conditions is TRUE:
> @@ -464,7 +464,7 @@ typedef enum {
> @param[in] BDAddr Remote BluetoothLE device
> address. For Local device setting, it
> should be NULL.
> @param[in] DataType Data type in
> EFI_BLUETOOTH_LE_SMP_DATA_TYPE.
> - @param[in, out] DataSize On input, indicates the size, in bytes,
of
> the data buffer specified
> + @param[in,out] DataSize On input, indicates the size, in bytes,
> of the data buffer specified
> by Data. On output, indicates the
> amount of data actually returned.
> @param[out] Data A pointer to the buffer of data that
> will be returned.
>
> diff --git a/MdePkg/Include/Protocol/CcMeasurement.h
> b/MdePkg/Include/Protocol/CcMeasurement.h
> index 4bf21fc42fa0..555356d56d66 100644
> --- a/MdePkg/Include/Protocol/CcMeasurement.h
> +++ b/MdePkg/Include/Protocol/CcMeasurement.h
> @@ -139,7 +139,7 @@ typedef struct {
> capability information and state information.
>
> @param[in] This Indicates the calling context
> - @param[in, out] ProtocolCapability The caller allocates memory for a
> EFI_CC_BOOT_SERVICE_CAPABILITY
> + @param[in,out] ProtocolCapability The caller allocates memory for a
> EFI_CC_BOOT_SERVICE_CAPABILITY
> structure and sets the size
> field to the size of the structure allocated.
> The callee fills in the fields
> with the EFI CC BOOT Service capability
> information and the current
> CC information.
> diff --git a/MdePkg/Include/Protocol/CpuIo2.h
> b/MdePkg/Include/Protocol/CpuIo2.h
> index 39ddda62bfcf..baddbeb51de5 100644
> --- a/MdePkg/Include/Protocol/CpuIo2.h
> +++ b/MdePkg/Include/Protocol/CpuIo2.h
> @@ -81,7 +81,7 @@ typedef enum {
> @param[in] Address The base address of the I/O operation.
> @param[in] Count The number of I/O operations to perform.
> The number
> of bytes moved is Width size * Count,
> starting at Address.
> - @param[in, out] Buffer For read operations, the destination buffer
to
> store the results.
> + @param[in,out] Buffer For read operations, the destination buffer
> to store the results.
> For write operations, the source buffer
> from which to write data.
>
> @retval EFI_SUCCESS The data was read from or written to
> the PI system.
> diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h
> index 37b94b55c998..2c69772225ad 100644
> --- a/MdePkg/Include/Protocol/Eap.h
> +++ b/MdePkg/Include/Protocol/Eap.h
> @@ -54,7 +54,7 @@ typedef VOID *EFI_PORT_HANDLE;
> @param[in] RequestSize Packet size in bytes for the most
> recently received
> EAP-Request packet.
> @param[in] Buffer Pointer to the buffer to hold the built
> packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes.
> + @param[in,out] BufferSize Pointer to the buffer size in bytes.
> On input, it is the buffer size
> provided by the caller.
> On output, it is the buffer size in
> fact needed to contain
> the packet.
> diff --git a/MdePkg/Include/Protocol/EapConfiguration.h
> b/MdePkg/Include/Protocol/EapConfiguration.h
> index 6fcddabcb7b2..4bd100677b55 100644
> --- a/MdePkg/Include/Protocol/EapConfiguration.h
> +++ b/MdePkg/Include/Protocol/EapConfiguration.h
> @@ -114,8 +114,8 @@ EFI_STATUS
> @param[in] This Pointer to the
> EFI_EAP_CONFIGURATION_PROTOCOL instance.
> @param[in] EapType EAP type.
> @param[in] DataType Configuration data type.
> - @param[in, out] Data Pointer to configuration data.
> - @param[in, out] DataSize Total size of configuration data. On
> input, it means
> + @param[in,out] Data Pointer to configuration data.
> + @param[in,out] DataSize Total size of configuration data. On
> input, it means
> the size of Data buffer. On output,
> it means the size
> of copied Data buffer if
> EFI_SUCCESS, and means the
> size of desired Data buffer if
> EFI_BUFFER_TOO_SMALL.
> diff --git a/MdePkg/Include/Protocol/EapManagement.h
> b/MdePkg/Include/Protocol/EapManagement.h
> index ea1b0d71e357..20f915e30cf5 100644
> --- a/MdePkg/Include/Protocol/EapManagement.h
> +++ b/MdePkg/Include/Protocol/EapManagement.h
> @@ -294,7 +294,7 @@ EFI_STATUS
> instance that indicates the calling
> context.
> @param[out] CurrentState Returns the current state of the
> Supplicant PAE
> state machine for the Port.
> - @param[in, out] Configuration Returns the configuration of the
> operational
> + @param[in,out] Configuration Returns the configuration of the
> operational
> parameters of the Supplicant PAE
> state machine
> for the Port as required. This
> parameter can be
> NULL to ignore reading the
> configuration.
> diff --git a/MdePkg/Include/Protocol/EapManagement2.h
> b/MdePkg/Include/Protocol/EapManagement2.h
> index ab42b04e1a04..768f82b6aab2 100644
> --- a/MdePkg/Include/Protocol/EapManagement2.h
> +++ b/MdePkg/Include/Protocol/EapManagement2.h
> @@ -33,10 +33,10 @@ typedef struct
> _EFI_EAP_MANAGEMENT2_PROTOCOL
> EFI_EAP_MANAGEMENT2_PROTOCOL;
> MAC layer driver can use MSK to derive more keys, e.g. PMK (Pairwise
> Master Key).
>
> @param[in] This Pointer to the
> EFI_EAP_MANAGEMENT2_PROTOCOL instance.
> - @param[in, out] Msk Pointer to MSK (Master Session Key)
> buffer.
> - @param[in, out] MskSize MSK buffer size.
> - @param[in, out] Emsk Pointer to EMSK (Extended Master
> Session Key) buffer.
> - @param[in, out] EmskSize EMSK buffer size.
> + @param[in,out] Msk Pointer to MSK (Master Session
> Key) buffer.
> + @param[in,out] MskSize MSK buffer size.
> + @param[in,out] Emsk Pointer to EMSK (Extended Master
> Session Key) buffer.
> + @param[in,out] EmskSize EMSK buffer size.
>
> @retval EFI_SUCCESS The operation completed
> successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following
> conditions is TRUE:
> diff --git a/MdePkg/Include/Protocol/EraseBlock.h
> b/MdePkg/Include/Protocol/EraseBlock.h
> index bfa5921400aa..5f71ccdf9a0e 100644
> --- a/MdePkg/Include/Protocol/EraseBlock.h
> +++ b/MdePkg/Include/Protocol/EraseBlock.h
> @@ -45,7 +45,7 @@ typedef struct {
> @param[in] LBA The starting logical block address
> to be
> erased. The caller is responsible
> for erasing
> only legitimate locations.
> - @param[in, out] Token A pointer to the token associated
> with the
> + @param[in,out] Token A pointer to the token associated
> with the
> transaction.
> @param[in] Size The size in bytes to be erased. This
> must be
> a multiple of the physical block
> size of the
> diff --git a/MdePkg/Include/Protocol/FirmwareManagement.h
> b/MdePkg/Include/Protocol/FirmwareManagement.h
> index f37067df3455..3bdebc29accd 100644
> --- a/MdePkg/Include/Protocol/FirmwareManagement.h
> +++ b/MdePkg/Include/Protocol/FirmwareManagement.h
> @@ -286,12 +286,12 @@ EFI_STATUS
> The saved copy could later been used, for example, in firmware image
> recovery or rollback.
>
> @param[in] This A pointer to the
> EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance.
> - @param[in, out] ImageInfoSize A pointer to the size, in bytes, of
the
> ImageInfo buffer.
> + @param[in,out] ImageInfoSize A pointer to the size, in bytes, of
> the ImageInfo buffer.
> On input, this is the size of the
> buffer allocated by the caller.
> On output, it is the size of the
> buffer returned by the firmware
> if the buffer was large enough,
> or the size of the buffer needed
> to contain the image(s)
> information if the buffer was too small.
> - @param[in, out] ImageInfo A pointer to the buffer in which
> firmware places the current image(s)
> + @param[in,out] ImageInfo A pointer to the buffer in which
> firmware places the current image(s)
> information. The information
> is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs.
> @param[out] DescriptorVersion A pointer to the location in which
> firmware returns the version number
> associated with the
> EFI_FIRMWARE_IMAGE_DESCRIPTOR.
> @@ -340,7 +340,7 @@ EFI_STATUS
> @param[in] ImageIndex A unique number identifying the
> firmware image(s) within the device.
> The number is between 1 and
> DescriptorCount.
> @param[out] Image Points to the buffer where the
> current image is copied to.
> - @param[in, out] ImageSize On entry, points to the size of the
buffer
> pointed to by Image, in bytes.
> + @param[in,out] ImageSize On entry, points to the size of the
> buffer pointed to by Image, in bytes.
> On return, points to the length of
> the image, in bytes.
>
> @retval EFI_SUCCESS The device was successfully updated
> with the new image.
> diff --git a/MdePkg/Include/Protocol/I2cEnumerate.h
> b/MdePkg/Include/Protocol/I2cEnumerate.h
> index e1890e470c62..be07979043ae 100644
> --- a/MdePkg/Include/Protocol/I2cEnumerate.h
> +++ b/MdePkg/Include/Protocol/I2cEnumerate.h
> @@ -28,7 +28,7 @@ typedef struct _EFI_I2C_ENUMERATE_PROTOCOL
> EFI_I2C_ENUMERATE_PROTOCOL;
>
> @param[in] This The platform data for the next device
> on
> the I2C bus was returned
> successfully.
> - @param[in, out] Device Pointer to a buffer containing an
> + @param[in,out] Device Pointer to a buffer containing an
> EFI_I2C_DEVICE structure.
> Enumeration is
> started by setting the initial
> EFI_I2C_DEVICE
> structure pointer to NULL. The
> buffer
> diff --git a/MdePkg/Include/Protocol/IpSec.h
> b/MdePkg/Include/Protocol/IpSec.h
> index 0b5d55a85293..6295bf43d401 100644
> --- a/MdePkg/Include/Protocol/IpSec.h
> +++ b/MdePkg/Include/Protocol/IpSec.h
> @@ -55,11 +55,11 @@ typedef struct _EFI_IPSEC_FRAGMENT_DATA {
> @param[in] This Pointer to the
> EFI_IPSEC_PROTOCOL instance.
> @param[in] NicHandle Instance of the network
> interface.
> @param[in] IpVer IPV4 or IPV6.
> - @param[in, out] IpHead Pointer to the IP Header.
> + @param[in,out] IpHead Pointer to the IP Header.
> @param[in] LastHead The protocol of the next layer to
> be processed by IPsec.
> @param[in] OptionsBuffer Pointer to the options buffer.
> @param[in] OptionsLength Length of the options buffer.
> - @param[in, out] FragmentTable Pointer to a list of fragments.
> + @param[in,out] FragmentTable Pointer to a list of fragments.
> @param[in] FragmentCount Number of fragments.
> @param[in] TrafficDirection Traffic direction.
> @param[out] RecycleSignal Event for recycling of resources.
> @@ -111,7 +111,7 @@ struct _EFI_IPSEC_PROTOCOL {
> @param[in] This Pointer to the
> EFI_IPSEC2_PROTOCOL instance.
> @param[in] NicHandle Instance of the network
> interface.
> @param[in] IpVer IP version.IPv4 or IPv6.
> - @param[in, out] IpHead Pointer to the IP Header it is
> either
> + @param[in,out] IpHead Pointer to the IP Header it is
> either
> the EFI_IP4_HEADER or
> EFI_IP6_HEADER.
> On input, it contains the IP
> header.
> On output, 1) in tunnel mode
> and the
> @@ -123,10 +123,10 @@ struct _EFI_IPSEC_PROTOCOL {
> mode, the related fielders
> (like payload
> length, Next header) in IP
> header will
> be modified according to the
> condition.
> - @param[in, out] LastHead For IP4, it is the next protocol in
> IP
> + @param[in,out] LastHead For IP4, it is the next protocol
> in IP
> header. For IP6 it is the Next
> Header
> of the last extension header.
> - @param[in, out] OptionsBuffer On input, it contains the options
> + @param[in,out] OptionsBuffer On input, it contains the options
> (extensions header) to be
> processed by
> IPsec. On output, 1) in tunnel
> mode and
> the traffic direction is
> outbound, it
> @@ -143,10 +143,10 @@ struct _EFI_IPSEC_PROTOCOL {
> might be same with input's.
> The caller
> should take the responsibility
> to free
> the buffer both on input and
> on output.
> - @param[in, out] OptionsLength On input, the input length of the
> options
> + @param[in,out] OptionsLength On input, the input length of the
> options
> buffer. On output, the output
> length of
> the options buffer.
> - @param[in, out] FragmentTable Pointer to a list of fragments. On
> input,
> + @param[in,out] FragmentTable Pointer to a list of fragments.
> On input,
> these fragments contain the
> IP payload.
> On output, 1) in tunnel mode
> and the traffic
> direction is inbound, the
> fragments contain
> @@ -167,7 +167,7 @@ struct _EFI_IPSEC_PROTOCOL {
> payload which encapsulates
> the next layer
> protocol information
> between the encapsulated
> header and encapsulated
> trailer fields.
> - @param[in, out] FragmentCount Number of fragments.
> + @param[in,out] FragmentCount Number of fragments.
> @param[in] TrafficDirection Traffic direction.
> @param[out] RecycleSignal Event for recycling of resources.
>
> diff --git a/MdePkg/Include/Protocol/IpSecConfig.h
> b/MdePkg/Include/Protocol/IpSecConfig.h
> index 7136060691ca..2c9d3d8ddd45 100644
> --- a/MdePkg/Include/Protocol/IpSecConfig.h
> +++ b/MdePkg/Include/Protocol/IpSecConfig.h
> @@ -647,7 +647,7 @@ EFI_STATUS
> @param[in] DataType The type of data to retrieve.
> @param[in] Selector Pointer to an entry selector which is
> an identifier of the IPsec
> configuration data entry.
> - @param[in, out] DataSize On output the size of data returned in
> Data.
> + @param[in,out] DataSize On output the size of data returned in
> Data.
> @param[out] Data The buffer to return the contents of
> the IPsec configuration data.
> The type of the data buffer is
> associated with the DataType.
>
> @@ -692,8 +692,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_IPSEC_CONFIG_PROTOCOL instance.
> @param[in] DataType The type of IPsec configuration data
> to retrieve.
> - @param[in, out] SelectorSize The size of the Selector buffer.
> - @param[in, out] Selector On input, supplies the pointer to last
> Selector that was
> + @param[in,out] SelectorSize The size of the Selector buffer.
> + @param[in,out] Selector On input, supplies the pointer to last
> Selector that was
> returned by GetNextSelector().
> On output, returns one copy of the
> current entry Selector
> of a given DataType.
> diff --git a/MdePkg/Include/Protocol/Kms.h
> b/MdePkg/Include/Protocol/Kms.h
> index c37fcbb65c63..b63e7d2cbd1b 100644
> --- a/MdePkg/Include/Protocol/Kms.h
> +++ b/MdePkg/Include/Protocol/Kms.h
> @@ -366,7 +366,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -379,7 +379,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if and
> only if the
> @@ -419,11 +419,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> processed by this operation.
> On return, this number
> will be updated with the
> number of key descriptors
> successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> structures which describe the
> keys to be generated.
> On input, the KeyIdentifierSize
> and the KeyIdentifier
> may specify an identifier to be
> used for the key,
> @@ -447,7 +447,7 @@ EFI_STATUS
> type and must be freed by the
> caller when it is no longer
> needed. Also, the KeyStatus
> field must reflect the result
> of the request relative to that
> key.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -460,7 +460,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -514,11 +514,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> processed by this operation.
> On return, this number
> will be updated with the
> number of key descriptors
> successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> structures which describe the
> keys to be retrieved
> from the KMS.
> On input, the KeyIdentifierSize
> and the KeyIdentifier
> @@ -533,7 +533,7 @@ EFI_STATUS
> must be freed by the caller
> when it is no longer needed.
> Also, the KeyStatus field will
> reflect the result of the
> request relative to the
> individual key descriptor.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -546,7 +546,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -602,11 +602,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> processed by this operation.
> On normal return, this
> number will be updated with
> the number of key
> descriptors successfully
> processed.
> - @param[in, out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> structures which describe the
> keys to be added.
> On input, the KeyId field for
> first key must contain
> valid identifier data to be used
> for adding a key to
> @@ -619,7 +619,7 @@ EFI_STATUS
> consistent values to be
> associated with the given KeyId.
> On return, the KeyStatus field
> will reflect the result
> of the operation for each key
> request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -632,7 +632,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -688,11 +688,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors to be
> processed by this operation.
> On normal return, this
> number will be updated with
> the number of key
> descriptors successfully
> processed.
> - @param[in, out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> structures which describe the
> keys to be deleted.
> On input, the KeyId field for
> first key must contain
> valid identifier data to be used
> for adding a key to
> @@ -704,7 +704,7 @@ EFI_STATUS
> KeyValue fields are ignored,
> but should be 0.
> On return, the KeyStatus field
> will reflect the result
> of the operation for each key
> request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -717,7 +717,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -770,19 +770,19 @@ EFI_STATUS
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
> KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier
> associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> structures associated with the
> Key identifier. If none
> are found, the count value is
> zero on return.
> On input this value reflects
> the number of KeyAttributes
> that may be returned.
> On output, the value reflects
> the number of completed
> KeyAttributes structures
> found.
> - @param[in, out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> structures associated with the
> Key Identifier.
> On input, the fields in the
> structure should be NULL.
> On output, the attribute fields
> will have updated values
> for attributes associated with
> this key identifier.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -795,7 +795,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -858,18 +858,18 @@ EFI_STATUS
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
> KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier
> associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> structures to associate with
> the Key. On normal returns,
> this number will be updated
> with the number of key
> attributes successfully
> processed.
> - @param[in, out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> structures providing the
> attribute information to
> associate with the key.
> On input, the values for the
> fields in the structure
> are completely filled in.
> On return the
> KeyAttributeStatus field will reflect the
> result of the operation for
> each key attribute request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -882,7 +882,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -948,19 +948,19 @@ EFI_STATUS
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
> KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier
> associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of
> EFI_KMS_KEY_ATTRIBUTE
> structures to associate with
> the Key.
> On input, the count value is
> one or more.
> On normal returns, this
> number will be updated with
> the number of key attributes
> successfully processed.
> - @param[in, out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> structures providing the
> attribute information to
> associate with the key.
> On input, the values for the
> fields in the structure
> are completely filled in.
> On return the
> KeyAttributeStatus field will reflect the
> result of the operation for
> each key attribute request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -973,7 +973,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> @@ -1029,23 +1029,23 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid
> EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyAttributesCount Pointer to a count of the number of
> key attribute structures
> + @param[in,out] KeyAttributesCount Pointer to a count of the number of
> key attribute structures
> that must be matched for
> each returned key descriptor.
> On input the count value is
> one or more.
> On normal returns, this
> number will be updated with
> the number of key attributes
> successfully processed.
> - @param[in, out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of
> EFI_KMS_KEY_ATTRIBUTE
> structure to search for.
> On input, the values for the
> fields in the structure are
> completely filled in.
> On return the
> KeyAttributeStatus field will reflect the
> result of the operation for
> each key attribute request.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors matched
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
> key descriptors matched
> by this operation.
> On entry, this number will be
> zero.
> On return, this number will be
> updated to the number
> of key descriptors successfully
> found.
> - @param[in, out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of
> EFI_KMS_KEY_DESCRIPTOR
> structures which describe the
> keys from the KMS
> having the KeyAttribute(s)
> specified.
> On input, this pointer will be
> NULL.
> @@ -1057,7 +1057,7 @@ EFI_STATUS
> caller when it is no longer
> needed. Also, the KeyStatus
> field of each descriptor will
> reflect the result of the
> request relative to that key
> descriptor.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
> arbitrary block of
> data specified by the
> ClientData parameter. This
> parameter may be NULL, in
> which case the ClientData
> parameter will be ignored and
> no data will be
> @@ -1070,7 +1070,7 @@ EFI_STATUS
> In all cases, the value upon
> return to the caller will
> be the size of the data block
> returned to the caller,
> which will be zero if no data is
> returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
> block of data of
> + @param[in,out] ClientData Pointer to a pointer to an
> arbitrary block of data of
> *ClientDataSize that is to be
> passed directly to the
> KMS if it supports the use of
> client data. This
> parameter may be NULL if
> and only if the
> diff --git a/MdePkg/Include/Protocol/MmCommunication2.h
> b/MdePkg/Include/Protocol/MmCommunication2.h
> index 1b56320c7fff..86f74d9d2fa8 100644
> --- a/MdePkg/Include/Protocol/MmCommunication2.h
> +++ b/MdePkg/Include/Protocol/MmCommunication2.h
> @@ -28,9 +28,9 @@ typedef struct
> _EFI_MM_COMMUNICATION2_PROTOCOL
> EFI_MM_COMMUNICATION2_PROTOCOL;
> This function provides a service to send and receive messages from a
> registered UEFI service.
>
> @param[in] This The
> EFI_MM_COMMUNICATION_PROTOCOL instance.
> - @param[in, out] CommBufferPhysical Physical address of the MM
> communication buffer
> - @param[in, out] CommBufferVirtual Virtual address of the MM
> communication buffer
> - @param[in, out] CommSize The size of the data buffer being
> passed in. On exit, the
> + @param[in,out] CommBufferPhysical Physical address of the MM
> communication buffer
> + @param[in,out] CommBufferVirtual Virtual address of the MM
> communication buffer
> + @param[in,out] CommSize The size of the data buffer
> being passed in. On exit, the
> size of data being returned.
> Zero if the handler does not
> wish to reply with any data.
> This parameter is optional
> and may be NULL.
> diff --git a/MdePkg/Include/Protocol/MmSwDispatch.h
> b/MdePkg/Include/Protocol/MmSwDispatch.h
> index e7810662ecdb..fdecac020e5e 100644
> --- a/MdePkg/Include/Protocol/MmSwDispatch.h
> +++ b/MdePkg/Include/Protocol/MmSwDispatch.h
> @@ -62,7 +62,7 @@ typedef struct _EFI_MM_SW_DISPATCH_PROTOCOL
> EFI_MM_SW_DISPATCH_PROTOCOL;
> @param[in] This Pointer to the
> EFI_MM_SW_DISPATCH_PROTOCOL instance.
> @param[in] DispatchFunction Function to register for handler
> when the specified software
> MMI is generated.
> - @param[in, out] RegisterContext Pointer to the dispatch function's
> context.
> + @param[in,out] RegisterContext Pointer to the dispatch function's
> context.
> The caller fills this context in
> before calling
> the register function to indicate
> to the register
> function which Software MMI
> input value the
> diff --git a/MdePkg/Include/Protocol/Mtftp6.h
> b/MdePkg/Include/Protocol/Mtftp6.h
> index 4abf296c1c01..ce5a1409c943 100644
> --- a/MdePkg/Include/Protocol/Mtftp6.h
> +++ b/MdePkg/Include/Protocol/Mtftp6.h
> @@ -368,7 +368,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL
> instance.
> @param[in] Token The token provided in the
> EFI_MTFTP6_PROTOCOL.WriteFile() by the caller.
> - @param[in, out] Length Indicates the length of the raw data wanted on
> input, and the
> + @param[in,out] Length Indicates the length of the raw data wanted
> on input, and the
> length the data available on output.
> @param[out] Buffer Pointer to the buffer where the data is
> stored.
>
> diff --git a/MdePkg/Include/Protocol/Pcd.h b/MdePkg/Include/Protocol/Pcd.h
> index 25f73cda1423..56c7f03e2c99 100644
> --- a/MdePkg/Include/Protocol/Pcd.h
> +++ b/MdePkg/Include/Protocol/Pcd.h
> @@ -424,7 +424,7 @@ EFI_STATUS
> If it is not, an error will be returned.
>
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfBuffer A pointer to the length of the value being
set
> for the PCD token.
> + @param[in,out] SizeOfBuffer A pointer to the length of the value being
> set for the PCD token.
> On input, if the SizeOfValue is greater
> than the maximum size supported
> for this TokenNumber then the output
> value of SizeOfValue will reflect
> the maximum size supported for this
> TokenNumber.
> @@ -582,7 +582,7 @@ EFI_STATUS
>
> @param[in] Guid The 128-bit unique value that
> designates the namespace from which to extract the value.
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfBuffer A pointer to the length of the value being
set
> for the PCD token.
> + @param[in,out] SizeOfBuffer A pointer to the length of the value being
> set for the PCD token.
> On input, if the SizeOfValue is greater
> than the maximum size supported
> for this TokenNumber then the output
> value of SizeOfValue will reflect
> the maximum size supported for this
> TokenNumber.
> @@ -643,7 +643,7 @@ EFI_STATUS
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being set.
> @param[in] TokenDataSize The size, in bytes, of the data being set.
>
> @retval VOID
> @@ -737,7 +737,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is
useful
> to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token namespace
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token namespace
> from which the search will start. On
> output, it designates the next valid token
> namespace on the platform. If *Guid is
> NULL, then the GUID of the first token
> space of the current platform is returned.
> If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/PiPcd.h
> b/MdePkg/Include/Protocol/PiPcd.h
> index e26733b5d9db..63b198c63e0e 100644
> --- a/MdePkg/Include/Protocol/PiPcd.h
> +++ b/MdePkg/Include/Protocol/PiPcd.h
> @@ -379,7 +379,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is
useful
> to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token namespace
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
> designates a known token namespace
> from which the search will start. On
> output, it designates the next valid token
> namespace on the platform. If *Guid is
> NULL, then the GUID of the first token
> space of the current platform is returned.
> If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/S3SaveState.h
> b/MdePkg/Include/Protocol/S3SaveState.h
> index c2b26944fb41..f9f45e0a115a 100644
> --- a/MdePkg/Include/Protocol/S3SaveState.h
> +++ b/MdePkg/Include/Protocol/S3SaveState.h
> @@ -72,7 +72,7 @@ EFI_STATUS
> in the boot script table
> specified by Position. If Position is NULL or points to
> NULL then the new opcode is
> inserted at the beginning of the table (if TRUE) or end
> of the table (if FALSE).
> - @param[in, out] Position On entry, specifies the position in
> the boot script table where the opcode will be
> + @param[in,out] Position On entry, specifies the position in
> the boot script table where the opcode will be
> inserted, either before or after,
> depending on BeforeOrAfter. On exit, specifies
> the position of the inserted
> opcode in the boot script table.
> @param[in] OpCode The operation code (opcode)
> number. See "Related Definitions" in Write() for the
> @@ -111,7 +111,7 @@ EFI_STATUS
> NULL then the new label is
> inserted at the beginning of the table (if TRUE) or end of
> the table (if FALSE).
> @param[in] CreateIfNotFound Specifies whether the label will
> be created if the label does not exists (TRUE) or not (FALSE).
> - @param[in, out] Position On entry, specifies the position in
> the boot script table where the label will be inserted,
> + @param[in,out] Position On entry, specifies the position
> in the boot script table where the label will be inserted,
> either before or after,
> depending on BeforeOrAfter. On exit, specifies the position
> of the inserted label in the
> boot script table.
> @param[in] Label Points to the label which will
> be inserted in the boot script table.
> diff --git a/MdePkg/Include/Protocol/Shell.h
> b/MdePkg/Include/Protocol/Shell.h
> index 5efee49e197a..413dd0e4acbb 100644
> --- a/MdePkg/Include/Protocol/Shell.h
> +++ b/MdePkg/Include/Protocol/Shell.h
> @@ -734,7 +734,7 @@ EFI_STATUS
> If there are multiple map names they will be semi-colon seperated in
the
> NULL-terminated string.
>
> - @param[in, out] DevicePath On entry, points to a device path
pointer.
> On
> + @param[in,out] DevicePath On entry, points to a device path
> pointer. On
> exit, updates the pointer to point to
> the
> portion of the device path after the
> mapping.
>
> @@ -846,7 +846,7 @@ EFI_STATUS
> @param[in] Path A pointer to the path string.
> @param[in] OpenMode Specifies the mode used to open
> each file, EFI_FILE_MODE_READ or
> EFI_FILE_MODE_WRITE.
> - @param[in, out] FileList Points to the start of a list of files
opened.
> + @param[in,out] FileList Points to the start of a list of files
> opened.
>
> @retval EFI_SUCCESS Create the file list successfully.
> @return Can't create the file list.
> @@ -915,7 +915,7 @@ EFI_STATUS
>
> @param[in] FileHandle The opened file handle for read.
> @param[in] ReadSize On input, the size of Buffer, in bytes.
> On output, the amount of data read.
> - @param[in, out] Buffer The buffer in which data is read.
> + @param[in,out] Buffer The buffer in which data is read.
>
> @retval EFI_SUCCESS Data was read.
> @retval EFI_NO_MEDIA The device has no media.
> @@ -1157,7 +1157,7 @@ EFI_STATUS
> Direct writes to opened directories are not supported.
>
> @param[in] FileHandle The opened file handle for
> writing.
> - @param[in, out] BufferSize On input, size of Buffer.
> + @param[in,out] BufferSize On input, size of Buffer.
> @param[in] Buffer The buffer in which data to
> write.
>
> @retval EFI_SUCCESS Data was written.
> diff --git a/MdePkg/Include/Protocol/SmartCardEdge.h
> b/MdePkg/Include/Protocol/SmartCardEdge.h
> index 1251680ec02f..2cf639a32633 100644
> --- a/MdePkg/Include/Protocol/SmartCardEdge.h
> +++ b/MdePkg/Include/Protocol/SmartCardEdge.h
> @@ -225,13 +225,13 @@ extern EFI_GUID gEfiPaddingRsaesOaepGuid;
>
> @param[in] This Indicates a pointer to the
> calling context.
> @param[out] NumberAidSupported Number of AIDs this
> protocol supports.
> - @param[in, out] AidTableSize On input, number of items
> allocated for the
> + @param[in,out] AidTableSize On input, number of items
> allocated for the
> AID table. On output,
> number of items returned
> by protocol.
> @param[out] AidTable Table of the AIDs supported
> by the protocol.
> @param[out] NumberSCPresent Number of currently
> present Smart Cards that
> are supported by protocol.
> - @param[in, out] CsnTableSize On input, the number of items
> the buffer CSN
> + @param[in,out] CsnTableSize On input, the number of items
> the buffer CSN
> table can contain. On
> output, the number of
> items returned by the
> protocol.
> @param[out] CsnTable Table of the CSN of the
> Smart Card present and
> @@ -343,7 +343,7 @@ EFI_STATUS
>
> @param[in] This Indicates a pointer to the calling
> context.
> @param[in] SCardHandle Handle on Smart Card
> connection.
> - @param[in, out] ReaderNameLength On input, a pointer to the variable
> that holds
> + @param[in,out] ReaderNameLength On input, a pointer to the
> variable that holds
> the maximal size, in bytes, of
> ReaderName.
> On output, the required size, in
> bytes, for ReaderName.
> @param[out] ReaderName A pointer to a NULL
> terminated string that will
> @@ -455,7 +455,7 @@ EFI_STATUS
> @param[in] This Indicates a pointer to the calling
> context.
> @param[in] SCardHandle Handle on Smart Card connection.
> @param[in] DataId The type identifier of the data to
> get.
> - @param[in, out] DataSize On input, in bytes, the size of Data. On
> output,
> + @param[in,out] DataSize On input, in bytes, the size of Data. On
> output,
> in bytes, the size of buffer required
> to store
> the specified data.
> @param[out] Data The data buffer in which the data is
> returned.
> @@ -507,7 +507,7 @@ EFI_STATUS
>
> @param[in] This Indicates a pointer to the calling
> context.
> @param[in] SCardHandle Handle on Smart Card connection.
> - @param[in, out] CredentialSize On input, in bytes, the size of buffer
to
> store
> + @param[in,out] CredentialSize On input, in bytes, the size of buffer
to
> store
> the list of credential.
> On output, in bytes, the size of
> buffer required
> to store the entire list of
> credentials.
> @@ -623,7 +623,7 @@ EFI_STATUS
> -
> EFI_PADDING_RSAES_OAEP_GUID
> @param[in] EncryptedSize Size of data to decrypt.
> @param[in] EncryptedData Data to decrypt
> - @param[in, out] PlaintextSize On input, in bytes, the size of buffer
to
> store
> + @param[in,out] PlaintextSize On input, in bytes, the size of buffer
to
> store
> the decrypted data.
> On output, in bytes, the size of
> buffer required
> to store the decrypted data.
> diff --git a/MdePkg/Include/Protocol/SmartCardReader.h
> b/MdePkg/Include/Protocol/SmartCardReader.h
> index 0ce117c9c764..a65b40932ec5 100644
> --- a/MdePkg/Include/Protocol/SmartCardReader.h
> +++ b/MdePkg/Include/Protocol/SmartCardReader.h
> @@ -135,13 +135,13 @@ EFI_STATUS
> @param[in] This Indicates a pointer to the calling
> context.
> @param[out] ReaderName A pointer to a NULL terminated
> string that will
> contain the reader name.
> - @param[in, out] ReaderNameLength On input, a pointer to the
> variablethat holds the
> + @param[in,out] ReaderNameLength On input, a pointer to the
> variablethat holds the
> maximal size, in bytes,of
> ReaderName.
> On output, the required size, in
> bytes, for ReaderName.
> @param[out] State Current state of the smart card
> reader.
> @param[out] CardProtocol Current protocol used to
> communicate with the smart card.
> @param[out] Atr A pointer to retrieve the ATR of
> the smart card.
> - @param[in, out] AtrLength On input, a pointer to hold the
> maximum size, in bytes,
> + @param[in,out] AtrLength On input, a pointer to hold the
> maximum size, in bytes,
> of Atr(usually 33).
> On output, the required size,
> inbytes, for the smart
> card ATR.
> @@ -184,7 +184,7 @@ EFI_STATUS
> @param[in] CAPDULength Command APDU size, in bytes.
> @param[out] RAPDU A pointer to a byte array that will
> contain the
> Response APDU.
> - @param[in, out] RAPDULength On input, the maximum size, inbytes, of
> the Response
> + @param[in,out] RAPDULength On input, the maximum size, inbytes,
> of the Response
> APDU.
> On output, the size, in bytes, of the
> Response APDU.
>
> @@ -226,7 +226,7 @@ EFI_STATUS
> @param[in] InBuffer A pointer to the input parameters.
> @param[in] InBufferLength Size, in bytes, of input parameters.
> @param[out] OutBuffer A pointer to the output
> parameters.
> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to
> store output
> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to
> store output
> parameters.
> On output, the size, in bytes, of
> output parameters.
>
> @@ -271,7 +271,7 @@ EFI_STATUS
> @param[in] Attrib Identifier for the attribute to
> retrieve.
> @param[out] OutBuffer A pointer to a buffer that will
> contain
> attribute data.
> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to
> store
> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to
> store
> attribute data.
> On output, the size, in bytes, of
> attribute
> data.
> diff --git a/MdePkg/Include/Protocol/Smbios.h
> b/MdePkg/Include/Protocol/Smbios.h
> index f9346aac7224..83e8065f6fa3 100644
> --- a/MdePkg/Include/Protocol/Smbios.h
> +++ b/MdePkg/Include/Protocol/Smbios.h
> @@ -97,7 +97,7 @@ typedef struct _EFI_SMBIOS_PROTOCOL
> EFI_SMBIOS_PROTOCOL;
>
> @param[in] This The
> EFI_SMBIOS_PROTOCOL instance.
> @param[in] ProducerHandle The handle of the controller
> or driver associated with the SMBIOS information. NULL means no handle.
> - @param[in, out] SmbiosHandle On entry, the handle of the
> SMBIOS record to add. If FFFEh, then a unique handle
> + @param[in,out] SmbiosHandle On entry, the handle of the
> SMBIOS record to add. If FFFEh, then a unique handle
> will be assigned to the
> SMBIOS record. If the SMBIOS handle is already in use,
> EFI_ALREADY_STARTED is
> returned and the SMBIOS record is not updated.
> @param[in] Record The data for the fixed
> portion of the SMBIOS record. The format of the record is
> @@ -168,7 +168,7 @@ EFI_STATUS
> only the SMBIOS records that match the optional Type argument.
>
> @param[in] This The EFI_SMBIOS_PROTOCOL
> instance.
> - @param[in, out] SmbiosHandle On entry, points to the previous
> handle of the SMBIOS record. On exit, points to the
> + @param[in,out] SmbiosHandle On entry, points to the previous
> handle of the SMBIOS record. On exit, points to the
> next SMBIOS record handle. If
> it is FFFEh on entry, then the first SMBIOS record
> handle will be returned. If it
> returns FFFEh on exit, then there are no more SMBIOS records.
> @param[in] Type On entry, it points to the type of
> the next SMBIOS record to return. If NULL, it
> diff --git a/MdePkg/Include/Protocol/SmmSwDispatch2.h
> b/MdePkg/Include/Protocol/SmmSwDispatch2.h
> index d0db953f06b0..27e91b5fb80f 100644
> --- a/MdePkg/Include/Protocol/SmmSwDispatch2.h
> +++ b/MdePkg/Include/Protocol/SmmSwDispatch2.h
> @@ -60,7 +60,7 @@ typedef struct _EFI_SMM_SW_DISPATCH2_PROTOCOL
> EFI_SMM_SW_DISPATCH2_PROTOCOL;
> @param[in] This Pointer to the
> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> @param[in] DispatchFunction Function to register for handler
> when the specified software
> SMI is generated.
> - @param[in, out] RegisterContext Pointer to the dispatch function's
> context.
> + @param[in,out] RegisterContext Pointer to the dispatch function's
> context.
> The caller fills this context in
> before calling
> the register function to indicate
> to the register
> function which Software SMI
> input value the
> diff --git a/MdePkg/Include/Protocol/SuperIo.h
> b/MdePkg/Include/Protocol/SuperIo.h
> index 802615030c91..bc7655e27281 100644
> --- a/MdePkg/Include/Protocol/SuperIo.h
> +++ b/MdePkg/Include/Protocol/SuperIo.h
> @@ -45,7 +45,7 @@ typedef struct _EFI_SIO_PROTOCOL
> EFI_SIO_PROTOCOL;
> The Super I/O driver must track the
> current state of the Super I/O and enable the
> configuration mode of Super I/O if
> necessary prior to register access.
> @param[in] Register Register number.
> - @param[in, out] Value If Write is TRUE, Value is a pointer to
> the buffer containing the byte of data to be
> + @param[in,out] Value If Write is TRUE, Value is a pointer to
> the buffer containing the byte of data to be
> written to the Super I/O register. If
> Write is FALSE, Value is a pointer to the
> destination buffer for the byte of
> data to be read from the Super I/O register.
>
> diff --git a/MdePkg/Include/Protocol/Supplicant.h
> b/MdePkg/Include/Protocol/Supplicant.h
> index d78622112583..0c44673482b5 100644
> --- a/MdePkg/Include/Protocol/Supplicant.h
> +++ b/MdePkg/Include/Protocol/Supplicant.h
> @@ -311,7 +311,7 @@ typedef struct {
> RequestBuffer is NULL.
> @param[out] Buffer Pointer to the buffer to hold the
> built
> packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
> input, it is the buffer size provided
> by the
> caller. On output, it is the buffer
> size in
> fact needed to contain the
> packet.
> @@ -347,7 +347,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_SUPPLICANT_PROTOCOL
> instance.
> - @param[in, out] FragmentTable Pointer to a list of fragment. The
> caller
> + @param[in,out] FragmentTable Pointer to a list of fragment. The
> caller
> will take responsible to handle
> the original
> FragmentTable while it may be
> reallocated in
> Supplicant driver.
> @@ -410,7 +410,7 @@ EFI_STATUS
> @param[in] DataType The type of data.
> @param[out] Data Pointer to the buffer to hold the
> data.
> Ignored if DataSize is 0.
> - @param[in, out] DataSize Pointer to the buffer size in bytes. On
> + @param[in,out] DataSize Pointer to the buffer size in bytes.
> On
> input, it is the buffer size provided
> by the
> caller. On output, it is the buffer
> size in
> fact needed to contain the
> packet.
> diff --git a/MdePkg/Include/Protocol/Tcg2Protocol.h
> b/MdePkg/Include/Protocol/Tcg2Protocol.h
> index f1326a5ef022..7199b6407666 100644
> --- a/MdePkg/Include/Protocol/Tcg2Protocol.h
> +++ b/MdePkg/Include/Protocol/Tcg2Protocol.h
> @@ -143,7 +143,7 @@ typedef struct tdEFI_TCG2_EVENT {
> capability information and state information.
>
> @param[in] This Indicates the calling context
> - @param[in, out] ProtocolCapability The caller allocates memory for a
> EFI_TCG2_BOOT_SERVICE_CAPABILITY
> + @param[in,out] ProtocolCapability The caller allocates memory for a
> EFI_TCG2_BOOT_SERVICE_CAPABILITY
> structure and sets the size
> field to the size of the structure allocated.
> The callee fills in the fields
> with the EFI protocol capability information
> and the current EFI TCG2 state
> information up to the number of fields which
> diff --git a/MdePkg/Include/Protocol/Tls.h b/MdePkg/Include/Protocol/Tls.h
> index edcf0e3e728c..24c902530b44 100644
> --- a/MdePkg/Include/Protocol/Tls.h
> +++ b/MdePkg/Include/Protocol/Tls.h
> @@ -376,8 +376,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_TLS_PROTOCOL
> instance.
> @param[in] DataType TLS session data type.
> - @param[in, out] Data Pointer to session data.
> - @param[in, out] DataSize Total size of session data. On input,
it
> means
> + @param[in,out] Data Pointer to session data.
> + @param[in,out] DataSize Total size of session data. On input,
it
> means
> the size of Data buffer. On output,
> it means the size
> of copied Data buffer if
> EFI_SUCCESS, and means the
> size of desired Data buffer if
> EFI_BUFFER_TOO_SMALL.
> @@ -422,7 +422,7 @@ EFI_STATUS
> @param[in] RequestSize Packet size in bytes for the most
> recently received TLS
> packet. 0 is only valid when
> RequestBuffer is NULL.
> @param[out] Buffer Pointer to the buffer to hold the
> built packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
> input, it is
> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
> input, it is
> the buffer size provided by the
> caller. On output, it
> is the buffer size in fact needed to
> contain the
> packet.
> @@ -456,7 +456,7 @@ EFI_STATUS
> The ProcessPacket () function process each inbound or outbound TLS APP
> packet.
>
> @param[in] This Pointer to the EFI_TLS_PROTOCOL
> instance.
> - @param[in, out] FragmentTable Pointer to a list of fragment. The
> caller will take
> + @param[in,out] FragmentTable Pointer to a list of fragment. The
> caller will take
> responsible to handle the original
> FragmentTable while
> it may be reallocated in TLS driver.
> If CryptMode is
> EfiTlsEncrypt, on input these
> fragments contain the TLS
> diff --git a/MdePkg/Include/Protocol/TlsConfig.h
> b/MdePkg/Include/Protocol/TlsConfig.h
> index 8b2a94d41f8e..9b9019338757 100644
> --- a/MdePkg/Include/Protocol/TlsConfig.h
> +++ b/MdePkg/Include/Protocol/TlsConfig.h
> @@ -87,8 +87,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the
> EFI_TLS_CONFIGURATION_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> - @param[in, out] Data Pointer to configuration data.
> - @param[in, out] DataSize Total size of configuration data. On
> input, it means
> + @param[in,out] Data Pointer to configuration data.
> + @param[in,out] DataSize Total size of configuration data. On
> input, it means
> the size of Data buffer. On output,
> it means the size
> of copied Data buffer if
> EFI_SUCCESS, and means the
> size of desired Data buffer if
> EFI_BUFFER_TOO_SMALL.
> diff --git a/MdePkg/Include/Protocol/UfsDeviceConfig.h
> b/MdePkg/Include/Protocol/UfsDeviceConfig.h
> index 34676c7831c5..ae0253ae4f64 100644
> --- a/MdePkg/Include/Protocol/UfsDeviceConfig.h
> +++ b/MdePkg/Include/Protocol/UfsDeviceConfig.h
> @@ -34,8 +34,8 @@ typedef struct _EFI_UFS_DEVICE_CONFIG_PROTOCOL
> EFI_UFS_DEVICE_CONFIG_PROTOCOL;
> @param[in] DescId The ID of device descriptor.
> @param[in] Index The Index of device descriptor.
> @param[in] Selector The Selector of device descriptor.
> - @param[in, out] Descriptor The buffer of device descriptor to be
read
> or written.
> - @param[in, out] DescSize The size of device descriptor buffer. On
> input, the size, in bytes,
> + @param[in,out] Descriptor The buffer of device descriptor to be
> read or written.
> + @param[in,out] DescSize The size of device descriptor buffer. On
> input, the size, in bytes,
> of the data buffer specified by
> Descriptor. On output, the number
> of bytes that were actually
> transferred.
>
> @@ -68,7 +68,7 @@ EFI_STATUS
> @param[in] This The pointer to the
> EFI_UFS_DEVICE_CONFIG_PROTOCOL instance.
> @param[in] Read The boolean variable to show r/w
> direction.
> @param[in] FlagId The ID of flag to be read or written.
> - @param[in, out] Flag The buffer to set or clear flag.
> + @param[in,out] Flag The buffer to set or clear flag.
>
> @retval EFI_SUCCESS The flag descriptor is set/clear
> successfully.
> @retval EFI_INVALID_PARAMETER This is NULL or Flag is NULL.
> @@ -96,8 +96,8 @@ EFI_STATUS
> @param[in] AttrId The ID of Attribute.
> @param[in] Index The Index of Attribute.
> @param[in] Selector The Selector of Attribute.
> - @param[in, out] Attribute The buffer of Attribute to be read or
> written.
> - @param[in, out] AttrSize The size of Attribute buffer. On input,
the
> size, in bytes, of the
> + @param[in,out] Attribute The buffer of Attribute to be read or
> written.
> + @param[in,out] AttrSize The size of Attribute buffer. On input,
> the size, in bytes, of the
> data buffer specified by Attribute.
> On output, the number of bytes
> that were actually transferred.
>
> diff --git a/MdePkg/Include/Protocol/UsbFunctionIo.h
> b/MdePkg/Include/Protocol/UsbFunctionIo.h
> index e360b604808e..3b0fcba69806 100644
> --- a/MdePkg/Include/Protocol/UsbFunctionIo.h
> +++ b/MdePkg/Include/Protocol/UsbFunctionIo.h
> @@ -343,7 +343,7 @@ EFI_STATUS
> @param[in] This A pointer to the
> EFI_USBFN_IO_PROTOCOL instance.
> @param[in] EndpointIndex Indicates the endpoint.
> @param[in] Direction Direction of the endpoint.
> - @param[in, out] State Boolean, true value indicates that the
> endpoint
> + @param[in,out] State Boolean, true value indicates that the
> endpoint
> is in a stalled state, false otherwise.
>
> @retval EFI_SUCCESS The function returned successfully.
> @@ -402,7 +402,7 @@ EFI_STATUS
>
> @param[in] This A pointer to the
> EFI_USBFN_IO_PROTOCOL instance.
> @param[out] Message Indicates the event that initiated this
> notification.
> - @param[in, out] PayloadSize On input, the size of the memory pointed
> by
> + @param[in,out] PayloadSize On input, the size of the memory
> pointed by
> Payload. On output, the amount
> ofdata returned
> in Payload.
> @param[out] Payload A pointer to
> EFI_USBFN_MESSAGE_PAYLOAD instance
> @@ -446,14 +446,14 @@ EFI_STATUS
> @param[in] EndpointIndex Indicates the endpoint on which TX or
> RX transfer
> needs to take place.
> @param[in] Direction Direction of the endpoint.
> - @param[in, out] BufferSize If Direction is
> EfiUsbEndpointDirectionDeviceRx:
> + @param[in,out] BufferSize If Direction is
> EfiUsbEndpointDirectionDeviceRx:
> On input, the size of the Bufferin
> bytes.
> On output, the amount of data
> returned in Buffer
> in bytes.
> If Direction is
> EfiUsbEndpointDirectionDeviceTx:
> On input, the size of the Bufferin
> bytes.
> On output, the amount of data
> transmitted in bytes.
> - @param[in, out] Buffer If Direction is
> EfiUsbEndpointDirectionDeviceRx:
> + @param[in,out] Buffer If Direction is
> EfiUsbEndpointDirectionDeviceRx:
> The Buffer to return the received
> data.
> If Directionis
> EfiUsbEndpointDirectionDeviceTx:
> The Buffer that contains the data
> to be transmitted.
> @@ -630,9 +630,9 @@ EFI_STATUS
> @param[in] Direction Direction of the endpoint.
> @param[in] PolicyType Policy type the user is trying to
> retrieve for
> the specified non-control endpoint.
> - @param[in, out] BufferSize On input, the size of Bufferin bytes. On
> output,
> + @param[in,out] BufferSize On input, the size of Bufferin bytes. On
> output,
> the amount of data returned in
> Bufferin bytes.
> - @param[in, out] Buffer A pointer to a buffer to return requested
> endpoint
> + @param[in,out] Buffer A pointer to a buffer to return
> requested endpoint
> policy value.
>
> @retval EFI_SUCCESS The function returned successfully.
> diff --git a/MdePkg/Include/Protocol/UserCredential.h
> b/MdePkg/Include/Protocol/UserCredential.h
> index 986cf44994f1..d1d957330493 100644
> --- a/MdePkg/Include/Protocol/UserCredential.h
> +++ b/MdePkg/Include/Protocol/UserCredential.h
> @@ -83,10 +83,10 @@ EFI_STATUS
> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is
> returned.
>
> @param[in] This Points to this instance of the
> EFI_USER_CREDENTIAL_PROTOCOL.
> - @param[in, out] Width On entry, points to the desired bitmap
> width. If NULL then no bitmap
> + @param[in,out] Width On entry, points to the desired
> bitmap width. If NULL then no bitmap
> information will be returned. On
> exit, points to the width of the
> bitmap returned.
> - @param[in, out] Height On entry, points to the desired bitmap
> height. If NULL then no bitmap
> + @param[in,out] Height On entry, points to the desired
> bitmap height. If NULL then no bitmap
> information will be returned. On
> exit, points to the height of the
> bitmap returned
> @param[out] Hii On return, holds the HII database
> handle.
> diff --git a/MdePkg/Include/Protocol/UserCredential2.h
> b/MdePkg/Include/Protocol/UserCredential2.h
> index fc64ba544a2b..caec534d61ef 100644
> --- a/MdePkg/Include/Protocol/UserCredential2.h
> +++ b/MdePkg/Include/Protocol/UserCredential2.h
> @@ -81,10 +81,10 @@ EFI_STATUS
> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is
> returned.
>
> @param[in] This Points to this instance of the
> EFI_USER_CREDENTIAL2_PROTOCOL.
> - @param[in, out] Width On entry, points to the desired bitmap
> width. If NULL then no bitmap
> + @param[in,out] Width On entry, points to the desired
> bitmap width. If NULL then no bitmap
> information will be returned. On
> exit, points to the width of the
> bitmap returned.
> - @param[in, out] Height On entry, points to the desired bitmap
> height. If NULL then no bitmap
> + @param[in,out] Height On entry, points to the desired
> bitmap height. If NULL then no bitmap
> information will be returned. On
> exit, points to the height of the
> bitmap returned
> @param[out] Hii On return, holds the HII database
> handle.
> diff --git a/MdePkg/Include/Uefi/UefiSpec.h
> b/MdePkg/Include/Uefi/UefiSpec.h
> index 7dfe35b4990b..516f4222d480 100644
> --- a/MdePkg/Include/Uefi/UefiSpec.h
> +++ b/MdePkg/Include/Uefi/UefiSpec.h
> @@ -169,7 +169,7 @@ typedef struct {
> 0x80000000..0xFFFFFFFF are
> reserved for use by UEFI OS loaders
> that are provided by operating
> system vendors.
> @param[in] Pages The number of contiguous 4 KB pages
> to allocate.
> - @param[in, out] Memory The pointer to a physical address. On
> input, the way in which the address is
> + @param[in,out] Memory The pointer to a physical address. On
> input, the way in which the address is
> used depends on the value of Type.
>
> @retval EFI_SUCCESS The requested pages were allocated.
> @@ -214,7 +214,7 @@ EFI_STATUS
> /**
> Returns the current memory map.
>
> - @param[in, out] MemoryMapSize A pointer to the size, in
> bytes, of the MemoryMap buffer.
> + @param[in,out] MemoryMapSize A pointer to the size, in
> bytes, of the MemoryMap buffer.
> On input, this is the size
> of the buffer allocated by the caller.
> On output, it is the size of
> the buffer returned by the firmware if
> the buffer was large
> enough, or the size of the buffer needed to contain
> @@ -391,7 +391,7 @@ EFI_STATUS
> Determines the new virtual address that is to be used on subsequent
> memory accesses.
>
> @param[in] DebugDisposition Supplies type information for the
> pointer being converted.
> - @param[in, out] Address A pointer to a pointer that is to be
> fixed to be the value needed
> + @param[in,out] Address A pointer to a pointer that is to
> be fixed to be the value needed
> for the new virtual address
> mappings being applied.
>
> @retval EFI_SUCCESS The pointer pointed to by Address was
> modified.
> @@ -650,7 +650,7 @@ VOID
> @param[in] VendorGuid A unique identifier for the vendor.
> @param[out] Attributes If not NULL, a pointer to the memory
> location to return the
> attributes bitmask for the variable.
> - @param[in, out] DataSize On input, the size in bytes of the
return
> Data buffer.
> + @param[in,out] DataSize On input, the size in bytes of the
> return Data buffer.
> On output the size of data returned
> in Data.
> @param[out] Data The buffer to return the contents of
> the variable. May be NULL
> with a zero DataSize in order to
> determine the size buffer needed.
> @@ -679,12 +679,12 @@ EFI_STATUS
> /**
> Enumerates the current variable names.
>
> - @param[in, out] VariableNameSize The size of the VariableName buffer.
> The size must be large
> + @param[in,out] VariableNameSize The size of the VariableName buffer.
> The size must be large
> enough to fit input string
> supplied in VariableName buffer.
> - @param[in, out] VariableName On input, supplies the last
> VariableName that was returned
> + @param[in,out] VariableName On input, supplies the last
> VariableName that was returned
> by GetNextVariableName(). On
> output, returns the Nullterminated
> string of the current variable.
> - @param[in, out] VendorGuid On input, supplies the last
> VendorGuid that was returned by
> + @param[in,out] VendorGuid On input, supplies the last
> VendorGuid that was returned by
> GetNextVariableName(). On
> output, returns the
> VendorGuid of the current
> variable.
>
> @@ -1155,7 +1155,7 @@ typedef enum {
> InstallMultipleProtocolInterfaces() be used in place of
> InstallProtocolInterface()
>
> - @param[in, out] Handle A pointer to the EFI_HANDLE on
> which the interface is to be installed.
> + @param[in,out] Handle A pointer to the EFI_HANDLE on
> which the interface is to be installed.
> @param[in] Protocol The numeric ID of the protocol
> interface.
> @param[in] InterfaceType Indicates whether Interface is
> supplied in native form.
> @param[in] Interface A pointer to the protocol interface.
> @@ -1180,7 +1180,7 @@ EFI_STATUS
> /**
> Installs one or more protocol interfaces into the boot services
> environment.
>
> - @param[in, out] Handle The pointer to a handle to install the
> new protocol interfaces on,
> + @param[in,out] Handle The pointer to a handle to install the
> new protocol interfaces on,
> or a pointer to NULL if a new handle
> is to be allocated.
> @param ... A variable argument list containing
> pairs of protocol GUIDs and protocol
> interfaces.
> @@ -1479,7 +1479,7 @@ typedef enum {
> @param[in] SearchType Specifies which handle(s) are to be
> returned.
> @param[in] Protocol Specifies the protocol to search by.
> @param[in] SearchKey Specifies the search key.
> - @param[in, out] BufferSize On input, the size in bytes of Buffer. On
> output, the size in bytes of
> + @param[in,out] BufferSize On input, the size in bytes of Buffer. On
> output, the size in bytes of
> the array returned in Buffer (if the
> buffer was large enough) or the
> size, in bytes, of the buffer needed
> to obtain the array (if the buffer was
> not large enough).
> @@ -1509,7 +1509,7 @@ EFI_STATUS
> Locates the handle to a device on the device path that supports the
> specified protocol.
>
> @param[in] Protocol Specifies the protocol to search for.
> - @param[in, out] DevicePath On input, a pointer to a pointer to the
> device path. On output, the device
> + @param[in,out] DevicePath On input, a pointer to a pointer to the
> device path. On output, the device
> path pointer is modified to point to
> the remaining part of the device
> path.
> @param[out] Device A pointer to the returned device
> handle.
> diff --git
> a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
> b.c
> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
> b.c
> index e6f479b829f6..dfdee0b5d2c0 100644
> ---
> a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
> b.c
> +++
> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
> b.c
> @@ -28,7 +28,7 @@ typedef struct {
> the registered guid and Handler list. When it is initialized, it will
be directly
> returned.
> Or, HandlerInfo table will be initialized in this function.
>
> - @param[in, out] InfoPointer The pointer to the handler information
> structure.
> + @param[in,out] InfoPointer The pointer to the handler information
> structure.
>
> @retval RETURN_SUCCESS HandlerInfo table can be
> used to store guid and function tables.
> @retval RETURN_OUT_OF_RESOURCES HandlerInfo table address is
> not writable.
> diff --git a/MdePkg/Library/BaseLib/QuickSort.c
> b/MdePkg/Library/BaseLib/QuickSort.c
> index d9f0e9a0f475..a7b7d0c6cd2b 100644
> --- a/MdePkg/Library/BaseLib/QuickSort.c
> +++ b/MdePkg/Library/BaseLib/QuickSort.c
> @@ -22,7 +22,7 @@
>
> if Count is < 2 then perform no action.
>
> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted)
> elements
> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted)
> elements
> on return a buffer of sorted
> elements
> @param[in] Count the number of elements in the
> buffer to sort
> @param[in] ElementSize Size of an element in bytes
> diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c
> b/MdePkg/Library/BasePcdLibNull/PcdLib.c
> index a214371c3fdf..39303cf429a7 100644
> --- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
> +++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c
> @@ -470,7 +470,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -645,7 +645,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set
> a value from.
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -819,7 +819,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer that was set.
> @@ -870,7 +870,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> @@ -923,7 +923,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -979,7 +979,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> index 417096f33493..63339fb4a627 100644
> --- a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> +++ b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> @@ -14,8 +14,8 @@
> instruction sets.
>
> @param[in] Reloc Pointer to the relocation record.
> - @param[in, out] Fixup Pointer to the address to fix up.
> - @param[in, out] FixupData Pointer to a buffer to log the fixups.
> + @param[in,out] Fixup Pointer to the address to fix up.
> + @param[in,out] FixupData Pointer to a buffer to log the fixups.
> @param[in] Adjust The offset to adjust the fixup.
>
> @return Status code.
> @@ -117,8 +117,8 @@ PeCoffLoaderImageFormatSupported (
> space for runtime calls.
>
> @param[in] Reloc The pointer to the relocation record.
> - @param[in, out] Fixup The pointer to the address to fix up.
> - @param[in, out] FixupData The pointer to a buffer to log the fixups.
> + @param[in,out] Fixup The pointer to the address to fix up.
> + @param[in,out] FixupData The pointer to a buffer to log the fixups.
> @param[in] Adjust The offset to adjust the fixup.
>
> @return Status code.
> diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c
> b/MdePkg/Library/DxePcdLib/DxePcdLib.c
> index b2a8bf22a365..c371f26f24c1 100644
> --- a/MdePkg/Library/DxePcdLib/DxePcdLib.c
> +++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c
> @@ -554,7 +554,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -731,7 +731,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set
> a value from.
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -926,7 +926,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -977,7 +977,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> @@ -1030,7 +1030,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -1086,7 +1086,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> diff --git
> a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> index c538f157a242..2436e2c8f62e 100644
> ---
> a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> +++
> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> @@ -28,7 +28,7 @@ typedef struct {
> Build guid hob for the global memory to store the registered guid and
> Handler list.
> If GuidHob exists, HandlerInfo will be directly got from Guid hob data.
>
> - @param[in, out] InfoPointer The pointer to pei handler information
> structure.
> + @param[in,out] InfoPointer The pointer to pei handler information
> structure.
>
> @retval RETURN_SUCCESS Build Guid hob for the global
> memory space to store guid and function tables.
> @retval RETURN_OUT_OF_RESOURCES No enough memory to
> allocated.
> diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> index 166d4a6f32d0..f16c1f8715a0 100644
> --- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> +++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> @@ -544,7 +544,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -721,7 +721,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set
> a value from.
> @param[in] TokenNumber The PCD token number to set a
> current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -918,7 +918,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -969,7 +969,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a
> module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> @@ -1022,7 +1022,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -1078,7 +1078,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
> PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the
> PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
Buffer.
> @param[in] Buffer A pointer to the buffer to used to set
> the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Library/SmmIoLib/SmmIoLib.c
> b/MdePkg/Library/SmmIoLib/SmmIoLib.c
> index ad4bfff68c8a..070a0c4f7b2a 100644
> --- a/MdePkg/Library/SmmIoLib/SmmIoLib.c
> +++ b/MdePkg/Library/SmmIoLib/SmmIoLib.c
> @@ -155,9 +155,9 @@ SmmIsMmioValid (
> /**
> Merge continuous entries whose type is
> EfiGcdMemoryTypeMemoryMappedIo.
>
> - @param[in, out] GcdMemoryMap A pointer to the buffer in
> which firmware places
> + @param[in,out] GcdMemoryMap A pointer to the buffer
> in which firmware places
> the current GCD
> memory map.
> - @param[in, out] NumberOfDescriptors A pointer to the number of
> the
> + @param[in,out] NumberOfDescriptors A pointer to the number of
> the
> GcdMemoryMap buffer.
> On input, this is the number of
> the current GCD
> memory map. On output,
> it is the number of new
> GCD memory map after merge.
> diff --git a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> index ff143f00ab9a..1ba604b0cdda 100644
> --- a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> +++ b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> @@ -723,7 +723,7 @@ PeriodicSmiDispatchFunctionOnCpu (
> released to notify the CPU that is running the SMM Foundation that the
> periodic
> SMI handler execution has finished its execution.
>
> - @param[in, out] Buffer A pointer to the context for the periodic SMI
> handler.
> + @param[in,out] Buffer A pointer to the context for the periodic SMI
> handler.
>
> **/
> VOID
> @@ -758,10 +758,10 @@ PeriodicSmiDispatchFunctionWithLock (
> SmiHandlerRegister().
> @param[in] Context Points to an optional handler
> context which was
> specified when the handler was
> registered.
> - @param[in, out] CommBuffer A pointer to a collection of data in
> memory that
> + @param[in,out] CommBuffer A pointer to a collection of data in
> memory that
> will be conveyed from a non-SMM
> environment into
> an SMM environment.
> - @param[in, out] CommBufferSize The size of the CommBuffer.
> + @param[in,out] CommBufferSize The size of the CommBuffer.
>
> @retval EFI_SUCCESS The interrupt was
> handled and quiesced.
> No other handlers
> should still be called.
> @@ -863,7 +863,7 @@ PeriodicSmiDispatchFunction (
> /**
> This function enables a periodic SMI handler.
>
> - @param[in, out] DispatchHandle A pointer to the handle associated
> with the
> + @param[in,out] DispatchHandle A pointer to the handle associated
> with the
> enabled periodic SMI handler.
> This is an
> optional parameter that may be
> NULL. If it is
> NULL, then the handle will not
> be returned,
> diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> index 86678e965d99..8fe52cab316f 100644
> --- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> +++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> @@ -697,8 +697,8 @@ FileHandleSetSize (
> if Destination's current length (including NULL terminator) is already
more
> then
> CurrentSize, then ASSERT()
>
> - @param[in, out] Destination The String to append onto
> - @param[in, out] CurrentSize on call the number of bytes in
Destination.
> On
> + @param[in,out] Destination The String to append onto
> + @param[in,out] CurrentSize on call the number of bytes in
> Destination. On
> return possibly the new size (still in
> bytes). if NULL
> then allocate whatever is needed.
> @param[in] Source The String to append from
> @@ -907,7 +907,7 @@ FileHandleGetFileName (
> maintained and not changed for all operations with the same file.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Ascii Boolean value for indicating whether
> the file is Ascii (TRUE) or UCS2 (FALSE);
> + @param[in,out] Ascii Boolean value for indicating whether
> the file is Ascii (TRUE) or UCS2 (FALSE);
>
> @return The line of text from the file.
>
> @@ -951,15 +951,15 @@ FileHandleReturnLine (
> read a CHAR_NULL character will be returned in buffer.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Buffer The pointer to buffer to read into.
> - @param[in, out] Size The pointer to number of bytes in
> Buffer.
> + @param[in,out] Buffer The pointer to buffer to read into.
> + @param[in,out] Size The pointer to number of bytes in
> Buffer.
> @param[in] Truncate If the buffer is large enough, this has
> no effect.
> If the buffer is is too small and
> Truncate is TRUE,
> the line will be truncated.
> If the buffer is is too small and
> Truncate is FALSE,
> then no read will occur.
>
> - @param[in, out] Ascii Boolean value for indicating whether
> the file is
> + @param[in,out] Ascii Boolean value for indicating whether
> the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @retval EFI_SUCCESS The operation was successful. The
> line is stored in
> diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> index a33cadd71646..af74ab732b21 100644
> --- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> +++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> @@ -81,12 +81,12 @@ typedef struct {
> is greater than zero, then this
> function will return
> EFI_TIMEOUT if the time
> required to execute the SCSI
> Request Packet is greater than
> Timeout.
> - @param[in, out] SenseData A pointer to sense data that was
> generated by
> + @param[in,out] SenseData A pointer to sense data that was
> generated by
> the execution of the SCSI
> Request Packet. This
> buffer must be allocated by the
> caller.
> If SenseDataLength is 0, then
> this parameter is
> optional and may be NULL.
> - @param[in, out] SenseDataLength On input, a pointer to the length in
> bytes of
> + @param[in,out] SenseDataLength On input, a pointer to the length in
> bytes of
> the SenseData buffer. On
> output, a pointer to
> the number of bytes written to
> the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that produces
> @@ -199,12 +199,12 @@ ScsiTestUnitReadyCommand (
> If Timeout is greater than
> zero, then this function
> will return EFI_TIMEOUT
> if the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that
> was generated
> + @param[in,out] SenseData A pointer to sense data
> that was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If SenseDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI
> @@ -218,12 +218,12 @@ ScsiTestUnitReadyCommand (
> See the EFI SCSI I/O
> Protocol in the UEFI
> Specification for details
> on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If InquiryDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the
> length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the
> length in bytes
> of the InquiryDataBuffer
> buffer.
> On output, a pointer to
> the number of bytes
> written to the
> InquiryDataBuffer buffer.
> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
> If Timeout is greater than
> zero, then this function
> will return EFI_TIMEOUT
> if the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that
> was generated
> + @param[in,out] SenseData A pointer to sense data
> that was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If SenseDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes
> of the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI
> @@ -366,12 +366,12 @@ ScsiInquiryCommandEx (
> See the EFI SCSI I/O
> Protocol in the UEFI
> Specification for details
> on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
> was generated
> by the execution of the
> SCSI Request Packet.
> This buffer must be
> allocated by the caller.
> If InquiryDataLength is 0,
> then this parameter
> is optional and may be
> NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the
> length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the
> length in bytes
> of the InquiryDataBuffer
> buffer.
> On output, a pointer to
> the number of bytes
> written to the
> InquiryDataBuffer buffer.
> @@ -464,12 +464,12 @@ ScsiInquiryCommand (
> If Timeout is greater than zero,
> then this function
> will return EFI_TIMEOUT if
> the time required to
> execute the SCSI Request
> Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was
> generated
> + @param[in,out] SenseData A pointer to sense data that was
> generated
> by the execution of the SCSI
> Request Packet.
> This buffer must be allocated
> by the caller.
> If SenseDataLength is 0, then
> this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of
> the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of
> the SenseData buffer.
> On output, the number of
> bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host
> Controller that
> produces the SCSI bus
> containing the SCSI target
> @@ -482,12 +482,12 @@ ScsiInquiryCommand (
> on the SCSI Host Controller.
> See the EFI SCSI
> I/O Protocol in the UEFI
> Specification for details
> on the possible return values.
> - @param[in, out] DataBuffer A pointer to data that was
> generated by the
> + @param[in,out] DataBuffer A pointer to data that was
> generated by the
> execution of the SCSI Request
> Packet. This
> buffer must be allocated by
> the caller. If
> DataLength is 0, then this
> parameter is optional
> and may be NULL.
> - @param[in, out] DataLength On input, a pointer to the length
> in bytes of
> + @param[in,out] DataLength On input, a pointer to the length
> in bytes of
> the DataBuffer buffer. On
> output, a pointer
> to the number of bytes
> written to the DataBuffer
> buffer.
> @@ -602,8 +602,8 @@ ScsiModeSense10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO
> protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output sense
> data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
>
> @@ -687,12 +687,12 @@ ScsiRequestSenseCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @@ -790,12 +790,12 @@ ScsiReadCapacityCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @@ -896,12 +896,12 @@ ScsiReadCapacity16Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 10 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 10 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -995,12 +995,12 @@ ScsiRead10Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -1095,12 +1095,12 @@ ScsiWrite10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -1194,12 +1194,12 @@ ScsiRead16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks of data that shall be transferred.
>
> @@ -1293,8 +1293,8 @@ ScsiWrite16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output
> sense data.
> + @param[in,out] SenseData A pointer to output
> sense data.
> + @param[in,out] SenseDataLength The length of output
> sense data.
> @param[out] HostAdapterStatus The status of Host
> Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to
> use.
> @@ -1302,7 +1302,7 @@ ScsiWrite16Command (
> @param[in] Inc512 If TRUE, 512
> increment (INC_512) bit will be set for the
> SECURITY PROTOCOL
> IN command.
> @param[in] DataLength The size in bytes of the
> data buffer.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data
> buffer.
> @param[out] TransferLength A pointer to a buffer to
> store the size in
> bytes of the data
> written to the data buffer.
>
> @@ -1408,8 +1408,8 @@ ScsiSecurityProtocolInCommand (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense
> data.
> - @param[in, out] SenseDataLength The length of output
> sense data.
> + @param[in,out] SenseData A pointer to output
> sense data.
> + @param[in,out] SenseDataLength The length of output
> sense data.
> @param[out] HostAdapterStatus The status of Host
> Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to
> use.
> @@ -1417,7 +1417,7 @@ ScsiSecurityProtocolInCommand (
> @param[in] Inc512 If TRUE, 512
> increment (INC_512) bit will be set for the
> SECURITY PROTOCOL
> OUT command.
> @param[in] DataLength The size in bytes of the
> transfer data.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data
> buffer.
>
> @retval EFI_SUCCESS Command is executed
> successfully.
> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was
> executed, but the entire DataBuffer could
> @@ -1573,12 +1573,12 @@ ScsiLibNotify (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -1756,12 +1756,12 @@ ScsiRead10CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -1939,12 +1939,12 @@ ScsiWrite10CommandEx (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> @@ -2122,12 +2122,12 @@ ScsiRead16CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout
> period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense
> data.
> + @param[in,out] SenseDataLength The length of output sense
> data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous
> logical blocks
> of data that shall be
> transferred.
> --
> 2.30.2
>
>
>
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: 回复: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-03-10 3:03 ` 回复: " gaoliming
@ 2023-03-14 18:06 ` Rebecca Cran
0 siblings, 0 replies; 7+ messages in thread
From: Rebecca Cran @ 2023-03-14 18:06 UTC (permalink / raw)
To: devel, gaoliming, 'Michael D Kinney',
'Zhiguang Liu'
Yes. In fact, the previous formatting wasn't technically in doxygen
format which is why clang complains.
See https://doxygen.nl/manual/commands.html#cmdparam :
The \param command has an optional attribute, dir, specifying the
direction of the parameter. Possible values are "[in]", "[in,out]", and
"[out]", note the [square] brackets in this description. When a
parameter is both input and output, [in,out] is used as attribute.
--
Rebecca Cran
On 3/9/23 8:03 PM, gaoliming via groups.io wrote:
> Rebecca:
> Does this change still follow DoxyGen format?
>
> Thanks
> Liming
>> -----邮件原件-----
>> 发件人: devel@edk2.groups.io <devel@edk2.groups.io> 代表 Rebecca Cran
>> 发送时间: 2023年2月21日 2:46
>> 收件人: devel@edk2.groups.io; Michael D Kinney
>> <michael.d.kinney@intel.com>; Liming Gao <gaoliming@byosoft.com.cn>;
>> Zhiguang Liu <zhiguang.liu@intel.com>
>> 抄送: Rebecca Cran <rebecca@quicinc.com>
>> 主题: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen
>> param passing direction [in,out]
>>
>> There isn't supposed to be whitespace for "@param [in,out]" between "in"
>> and "out". clang generates the following warning:
>>
>> test.c:8:9: warning: whitespace is not allowed in parameter passing
> direction
>> [-Wdocumentation-pedantic]
>> @param [in, out] argv Array of arguments.
>> ^~~~~~~~~
>> [in,out]
>>
>> Update the documentation blocks in MdePkg.
>>
>> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
>> ---
>> MdePkg/Include/Library/BaseLib.h
>> | 4 +-
>> MdePkg/Include/Library/FileHandleLib.h
>> | 12 +-
>> MdePkg/Include/Library/PcdLib.h
>> | 14 +--
>> MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> | 2 +-
>> MdePkg/Include/Library/UefiScsiLib.h
>> | 124 ++++++++++----------
>> MdePkg/Include/Ppi/CpuIo.h
>> | 2 +-
>> MdePkg/Include/Ppi/Graphics.h
>> | 2 +-
>> MdePkg/Include/Ppi/Pcd.h
>> | 10 +-
>> MdePkg/Include/Ppi/PiPcd.h
>> | 2 +-
>> MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> | 2 +-
>> MdePkg/Include/Protocol/BlockIo2.h
>> | 4 +-
>> MdePkg/Include/Protocol/BlockIoCrypto.h
>> | 6 +-
>> MdePkg/Include/Protocol/BluetoothHc.h
>> | 4 +-
>> MdePkg/Include/Protocol/BluetoothIo.h
>> | 4 +-
>> MdePkg/Include/Protocol/BluetoothLeConfig.h
>> | 10 +-
>> MdePkg/Include/Protocol/CcMeasurement.h
>> | 2 +-
>> MdePkg/Include/Protocol/CpuIo2.h
>> | 2 +-
>> MdePkg/Include/Protocol/Eap.h
>> | 2 +-
>> MdePkg/Include/Protocol/EapConfiguration.h
>> | 4 +-
>> MdePkg/Include/Protocol/EapManagement.h
>> | 2 +-
>> MdePkg/Include/Protocol/EapManagement2.h
>> | 8 +-
>> MdePkg/Include/Protocol/EraseBlock.h
>> | 2 +-
>> MdePkg/Include/Protocol/FirmwareManagement.h
>> | 6 +-
>> MdePkg/Include/Protocol/I2cEnumerate.h
>> | 2 +-
>> MdePkg/Include/Protocol/IpSec.h
>> | 16 +--
>> MdePkg/Include/Protocol/IpSecConfig.h
>> | 6 +-
>> MdePkg/Include/Protocol/Kms.h
>> | 72 ++++++------
>> MdePkg/Include/Protocol/MmCommunication2.h
>> | 6 +-
>> MdePkg/Include/Protocol/MmSwDispatch.h
>> | 2 +-
>> MdePkg/Include/Protocol/Mtftp6.h
>> | 2 +-
>> MdePkg/Include/Protocol/Pcd.h
>> | 8 +-
>> MdePkg/Include/Protocol/PiPcd.h
>> | 2 +-
>> MdePkg/Include/Protocol/S3SaveState.h
>> | 4 +-
>> MdePkg/Include/Protocol/Shell.h
>> | 8 +-
>> MdePkg/Include/Protocol/SmartCardEdge.h
>> | 12 +-
>> MdePkg/Include/Protocol/SmartCardReader.h
>> | 10 +-
>> MdePkg/Include/Protocol/Smbios.h
>> | 4 +-
>> MdePkg/Include/Protocol/SmmSwDispatch2.h
>> | 2 +-
>> MdePkg/Include/Protocol/SuperIo.h
>> | 2 +-
>> MdePkg/Include/Protocol/Supplicant.h
>> | 6 +-
>> MdePkg/Include/Protocol/Tcg2Protocol.h
>> | 2 +-
>> MdePkg/Include/Protocol/Tls.h
>> | 8 +-
>> MdePkg/Include/Protocol/TlsConfig.h
>> | 4 +-
>> MdePkg/Include/Protocol/UfsDeviceConfig.h
>> | 10 +-
>> MdePkg/Include/Protocol/UsbFunctionIo.h
>> | 12 +-
>> MdePkg/Include/Protocol/UserCredential.h
>> | 4 +-
>> MdePkg/Include/Protocol/UserCredential2.h
>> | 4 +-
>> MdePkg/Include/Uefi/UefiSpec.h
>> | 22 ++--
>>
>> MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.
>> c | 2 +-
>> MdePkg/Library/BaseLib/QuickSort.c
>> | 2 +-
>> MdePkg/Library/BasePcdLibNull/PcdLib.c
>> | 12 +-
>> MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> | 8 +-
>> MdePkg/Library/DxePcdLib/DxePcdLib.c
>> | 12 +-
>> MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> | 2 +-
>> MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> | 12 +-
>> MdePkg/Library/SmmIoLib/SmmIoLib.c
>> | 4 +-
>> MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> | 8 +-
>> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> | 12 +-
>> MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> | 124 ++++++++++----------
>> 59 files changed, 329 insertions(+), 329 deletions(-)
>>
>> diff --git a/MdePkg/Include/Library/BaseLib.h
>> b/MdePkg/Include/Library/BaseLib.h
>> index 8f2df76c29a3..0dee0f58aa75 100644
>> --- a/MdePkg/Include/Library/BaseLib.h
>> +++ b/MdePkg/Include/Library/BaseLib.h
>> @@ -2482,7 +2482,7 @@ BcdToDecimal8 (
>> /**
>> Removes the last directory or file entry in a path.
>>
>> - @param[in, out] Path The pointer to the path to modify.
>> + @param[in,out] Path The pointer to the path to modify.
>>
>> @retval FALSE Nothing was found to remove.
>> @retval TRUE A directory or file was removed.
>> @@ -2930,7 +2930,7 @@ INTN
>>
>> if Count is < 2 then perform no action.
>>
>> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted)
>> elements
>> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted)
>> elements
>> on return a buffer of sorted
>> elements
>> @param[in] Count the number of elements in the
>> buffer to sort
>> @param[in] ElementSize Size of an element in bytes
>> diff --git a/MdePkg/Include/Library/FileHandleLib.h
>> b/MdePkg/Include/Library/FileHandleLib.h
>> index 1a238edee38c..2ea97c317c27 100644
>> --- a/MdePkg/Include/Library/FileHandleLib.h
>> +++ b/MdePkg/Include/Library/FileHandleLib.h
>> @@ -78,7 +78,7 @@ FileHandleSetInfo (
>> EFI_FILE_INFO is the structure returned as the directory entry.
>>
>> @param[in] FileHandle The opened file handle.
>> - @param[in, out] BufferSize On input, the size of buffer in bytes.
> On
>> return,
>> + @param[in,out] BufferSize On input, the size of buffer in bytes.
>> On return,
>> the number of bytes written.
>> @param[out] Buffer The buffer to put read data into.
>>
>> @@ -109,7 +109,7 @@ FileHandleRead (
>> opened directories are not supported.
>>
>> @param[in] FileHandle The opened file for writing.
>> - @param[in, out] BufferSize On input, the number of bytes in Buffer.
>> On output,
>> + @param[in,out] BufferSize On input, the number of bytes in Buffer.
>> On output,
>> the number of bytes written.
>> @param[in] Buffer The buffer containing data to write is
>> stored.
>>
>> @@ -381,15 +381,15 @@ FileHandleGetFileName (
>> read a CHAR_NULL character will be returned in buffer.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Buffer The pointer to buffer to read into.
>> - @param[in, out] Size The pointer to number of bytes in
>> Buffer.
>> + @param[in,out] Buffer The pointer to buffer to read into.
>> + @param[in,out] Size The pointer to number of bytes in
>> Buffer.
>> @param[in] Truncate If the buffer is large enough, this has
>> no effect.
>> If the buffer is is too small and
>> Truncate is TRUE,
>> the line will be truncated.
>> If the buffer is is too small and
>> Truncate is FALSE,
>> then no read will occur.
>>
>> - @param[in, out] Ascii Boolean value for indicating whether
>> the file is
>> + @param[in,out] Ascii Boolean value for indicating whether
>> the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @retval EFI_SUCCESS The operation was successful. The
>> line is stored in
>> @@ -418,7 +418,7 @@ FileHandleReadLine (
>> maintained and not changed for all operations with the same file.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Ascii Boolean value for indicating whether
>> the file is
>> + @param[in,out] Ascii Boolean value for indicating whether
>> the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @return The line of text from the file.
>> diff --git a/MdePkg/Include/Library/PcdLib.h
>> b/MdePkg/Include/Library/PcdLib.h
>> index 4b103f0753c5..86739a3b2bd1 100644
>> --- a/MdePkg/Include/Library/PcdLib.h
>> +++ b/MdePkg/Include/Library/PcdLib.h
>> @@ -1158,7 +1158,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -1303,7 +1303,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set
>> a value from.
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -1354,7 +1354,7 @@ LibPcdSetExBoolS (
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being
>> set.
>> @param[in] TokenDataSize The size, in bytes, of the data being
>> set.
>>
>> **/
>> @@ -1474,7 +1474,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the Buffer that was set.
>> @@ -1506,7 +1506,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> @@ -1540,7 +1540,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the Buffer that was set.
>> @@ -1575,7 +1575,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> index 83d9bdde0eb8..dd3745d65af8 100644
>> --- a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> +++ b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> @@ -104,7 +104,7 @@ VOID
>> /**
>> This function enables a periodic SMI handler.
>>
>> - @param[in, out] DispatchHandle A pointer to the handle associated
>> with the
>> + @param[in,out] DispatchHandle A pointer to the handle associated
>> with the
>> enabled periodic SMI handler.
>> This is an
>> optional parameter that may be
>> NULL. If it is
>> NULL, then the handle will not
>> be returned,
>> diff --git a/MdePkg/Include/Library/UefiScsiLib.h
>> b/MdePkg/Include/Library/UefiScsiLib.h
>> index da6ac2df68e7..90db37456ad2 100644
>> --- a/MdePkg/Include/Library/UefiScsiLib.h
>> +++ b/MdePkg/Include/Library/UefiScsiLib.h
>> @@ -39,12 +39,12 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
>> is greater than zero, then this
>> function will return
>> EFI_TIMEOUT if the time
>> required to execute the SCSI
>> Request Packet is greater than
>> Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was
>> generated by
>> + @param[in,out] SenseData A pointer to sense data that was
>> generated by
>> the execution of the SCSI
>> Request Packet. This
>> buffer must be allocated by the
>> caller.
>> If SenseDataLength is 0, then
>> this parameter is
>> optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, a pointer to the length in
>> bytes of
>> + @param[in,out] SenseDataLength On input, a pointer to the length in
>> bytes of
>> the SenseData buffer. On
>> output, a pointer to
>> the number of bytes written to
>> the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that produces
>> @@ -122,12 +122,12 @@ ScsiTestUnitReadyCommand (
>> If Timeout is greater than
>> zero, then this function
>> will return EFI_TIMEOUT
>> if the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that
>> was generated
>> + @param[in,out] SenseData A pointer to sense data
>> that was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If SenseDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI
>> @@ -141,12 +141,12 @@ ScsiTestUnitReadyCommand (
>> See the EFI SCSI I/O
>> Protocol in the UEFI
>> Specification for details
>> on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If InquiryDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> of the InquiryDataBuffer
>> buffer.
>> On output, a pointer to
>> the number of bytes
>> written to the
>> InquiryDataBuffer buffer.
>> @@ -223,12 +223,12 @@ ScsiInquiryCommand (
>> If Timeout is greater than
>> zero, then this function
>> will return EFI_TIMEOUT
>> if the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that
>> was generated
>> + @param[in,out] SenseData A pointer to sense data
>> that was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If SenseDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI
>> @@ -242,12 +242,12 @@ ScsiInquiryCommand (
>> See the EFI SCSI I/O
>> Protocol in the UEFI
>> Specification for details
>> on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If InquiryDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> of the InquiryDataBuffer
>> buffer.
>> On output, a pointer to
>> the number of bytes
>> written to the
>> InquiryDataBuffer buffer.
>> @@ -329,12 +329,12 @@ ScsiInquiryCommandEx (
>> If Timeout is greater than zero,
>> then this function
>> will return EFI_TIMEOUT if
>> the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was
>> generated
>> + @param[in,out] SenseData A pointer to sense data that was
>> generated
>> by the execution of the SCSI
>> Request Packet.
>> This buffer must be allocated
>> by the caller.
>> If SenseDataLength is 0, then
>> this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of
>> the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of
>> the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI target
>> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
>> on the SCSI Host Controller.
>> See the EFI SCSI
>> I/O Protocol in the UEFI
>> Specification for details
>> on the possible return values.
>> - @param[in, out] DataBuffer A pointer to data that was
>> generated by the
>> + @param[in,out] DataBuffer A pointer to data that was
>> generated by the
>> execution of the SCSI Request
>> Packet. This
>> buffer must be allocated by
>> the caller. If
>> DataLength is 0, then this
>> parameter is optional
>> and may be NULL.
>> - @param[in, out] DataLength On input, a pointer to the length
>> in bytes of
>> + @param[in,out] DataLength On input, a pointer to the length
>> in bytes of
>> the DataBuffer buffer. On
>> output, a pointer
>> to the number of bytes
>> written to the DataBuffer
>> buffer.
>> @@ -420,8 +420,8 @@ ScsiModeSense10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO
>> protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output sense
>> data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>>
>> @@ -469,12 +469,12 @@ ScsiRequestSenseCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @@ -527,12 +527,12 @@ ScsiReadCapacityCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @@ -586,12 +586,12 @@ ScsiReadCapacity16Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 10 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 10 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -646,12 +646,12 @@ ScsiRead10Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -706,12 +706,12 @@ ScsiWrite10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -766,12 +766,12 @@ ScsiRead16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -825,8 +825,8 @@ ScsiWrite16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output
>> sense data.
>> + @param[in,out] SenseData A pointer to output
>> sense data.
>> + @param[in,out] SenseDataLength The length of output
>> sense data.
>> @param[out] HostAdapterStatus The status of Host
>> Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to
>> use.
>> @@ -834,7 +834,7 @@ ScsiWrite16Command (
>> @param[in] Inc512 If TRUE, 512
>> increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL
>> IN command.
>> @param[in] DataLength The size in bytes of the
>> data buffer.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data
>> buffer.
>> @param[out] TransferLength A pointer to a buffer to
>> store the size in
>> bytes of the data
>> written to the data buffer.
>>
>> @@ -889,8 +889,8 @@ ScsiSecurityProtocolInCommand (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output
>> sense data.
>> + @param[in,out] SenseData A pointer to output
>> sense data.
>> + @param[in,out] SenseDataLength The length of output
>> sense data.
>> @param[out] HostAdapterStatus The status of Host
>> Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to
>> use.
>> @@ -898,7 +898,7 @@ ScsiSecurityProtocolInCommand (
>> @param[in] Inc512 If TRUE, 512
>> increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL
>> OUT command.
>> @param[in] DataLength The size in bytes of the
>> transfer data.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data
>> buffer.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was
>> executed, but the entire DataBuffer could
>> @@ -960,12 +960,12 @@ ScsiSecurityProtocolOutCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -1049,12 +1049,12 @@ ScsiRead10CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -1138,12 +1138,12 @@ ScsiWrite10CommandEx (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -1227,12 +1227,12 @@ ScsiRead16CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
>> index 193a78e3c256..5e2ca4edbc22 100644
>> --- a/MdePkg/Include/Ppi/CpuIo.h
>> +++ b/MdePkg/Include/Ppi/CpuIo.h
>> @@ -46,7 +46,7 @@ typedef enum {
>> @param[in] Width The width of the access. Enumerated
>> in bytes.
>> @param[in] Address The physical address of the access.
>> @param[in] Count The number of accesses to perform.
>> - @param[in, out] Buffer A pointer to the buffer of data.
>> + @param[in,out] Buffer A pointer to the buffer of data.
>>
>> @retval EFI_SUCCESS The function completed successfully.
>> @retval EFI_NOT_YET_AVAILABLE The service has not been installed.
>> diff --git a/MdePkg/Include/Ppi/Graphics.h b/MdePkg/Include/Ppi/Graphics.h
>> index 3854f6c371c2..e8c1bc14b0ac 100644
>> --- a/MdePkg/Include/Ppi/Graphics.h
>> +++ b/MdePkg/Include/Ppi/Graphics.h
>> @@ -48,7 +48,7 @@ EFI_STATUS
>> The GraphicsPpiGetMode returns the mode information supported by the
>> Graphics PEI
>> Module.
>>
>> - @param[in, out] Mode Pointer to
>> EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>> + @param[in,out] Mode Pointer to
>> EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>>
>> @retval EFI_SUCCESS Valid mode information was
>> returned.
>> @retval EFI_INVALID_PARAMETER The Mode parameter is not valid.
>> diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
>> index d36a7f106cc8..3e6556314d1b 100644
>> --- a/MdePkg/Include/Ppi/Pcd.h
>> +++ b/MdePkg/Include/Ppi/Pcd.h
>> @@ -420,7 +420,7 @@ EFI_STATUS
>> If it is not, an error will be returned.
>>
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfValue A pointer to the length of the value being
>> set for the PCD token.
>> + @param[in,out] SizeOfValue A pointer to the length of the value being
>> set for the PCD token.
>> On input, if the SizeOfValue is greater
>> than the maximum size supported
>> for this TokenNumber then the output
>> value of SizeOfValue will reflect
>> the maximum size supported for this
>> TokenNumber.
>> @@ -578,7 +578,7 @@ EFI_STATUS
>>
>> @param[in] Guid The 128-bit unique value that
>> designates the namespace from which to extract the value.
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfValue A pointer to the length of the value being
>> set for the PCD token.
>> + @param[in,out] SizeOfValue A pointer to the length of the value being
>> set for the PCD token.
>> On input, if the SizeOfValue is greater
>> than the maximum size supported
>> for this TokenNumber then the output
>> value of SizeOfValue will reflect
>> the maximum size supported for this
>> TokenNumber.
>> @@ -638,7 +638,7 @@ EFI_STATUS
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being set.
>> @param[in] TokenDataSize The size, in bytes, of the data being
> set.
>> @retval VOID
>> @@ -712,7 +712,7 @@ EFI_STATUS
>> @param[in] Guid The 128-bit unique value that
>> designates the namespace from which to extract the value.
>> This is an optional parameter that
>> may be NULL. If this parameter is NULL, then a request
>> is being made to retrieve tokens from
>> the default token space.
>> - @param[in, out] TokenNumber A pointer to the PCD token number to
>> use to find the subsequent token number.
>> + @param[in,out] TokenNumber A pointer to the PCD token number to
>> use to find the subsequent token number.
>>
>> @retval EFI_SUCCESS The PCD service has retrieved the next valid
>> token number.
>> @retval EFI_NOT_FOUND The PCD service could not find data from the
>> requested token number.
>> @@ -731,7 +731,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is
> useful
>> to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token
>> namespace from which the search will
>> start. On output, it designates the next valid
>> token namespace on the platform. If
>> *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned.
>> If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
>> index 8d0f95eb27cc..8b137f2ca9e2 100644
>> --- a/MdePkg/Include/Ppi/PiPcd.h
>> +++ b/MdePkg/Include/Ppi/PiPcd.h
>> @@ -387,7 +387,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is
> useful
>> to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token
>> namespace from which the search will
>> start. On output, it designates the next valid
>> token namespace on the platform. If
>> *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned.
>> If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> index 9e134200da54..f25c3a7cd641 100644
>> --- a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> +++ b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> @@ -162,7 +162,7 @@ EFI_STATUS
>> Return the child ACPI objects.
>>
>> @param[in] ParentHandle Parent handle.
>> - @param[in, out] Handle On entry, points to the previously
>> returned handle or NULL to start with the first
>> + @param[in,out] Handle On entry, points to the previously
>> returned handle or NULL to start with the first
>> handle. On return, points to the
>> next returned ACPI handle or NULL if there are no
>> child objects.
>>
>> diff --git a/MdePkg/Include/Protocol/BlockIo2.h
>> b/MdePkg/Include/Protocol/BlockIo2.h
>> index d25f51f73354..9bd5e7a6ddd9 100644
>> --- a/MdePkg/Include/Protocol/BlockIo2.h
>> +++ b/MdePkg/Include/Protocol/BlockIo2.h
>> @@ -72,7 +72,7 @@ EFI_STATUS
>> @param[in] MediaId Id of the media, changes every time the
>> media is
>> replaced.
>> @param[in] Lba The starting Logical Block Address to
>> read from.
>> - @param[in, out] Token A pointer to the token associated with the
>> transaction.
>> + @param[in,out] Token A pointer to the token associated with
>> the transaction.
>> @param[in] BufferSize Size of Buffer, must be a multiple of
> device
>> block size.
>> @param[out] Buffer A pointer to the destination buffer for
>> the data. The
>> caller is responsible for either having
>> implicit or
>> @@ -116,7 +116,7 @@ EFI_STATUS
>> @param[in] Lba The starting logical block address to be
>> written. The
>> caller is responsible for writing to only
>> legitimate
>> locations.
>> - @param[in, out] Token A pointer to the token associated with the
>> transaction.
>> + @param[in,out] Token A pointer to the token associated with
>> the transaction.
>> @param[in] BufferSize Size of Buffer, must be a multiple of
> device
>> block size.
>> @param[in] Buffer A pointer to the source buffer for the
>> data.
>>
>> diff --git a/MdePkg/Include/Protocol/BlockIoCrypto.h
>> b/MdePkg/Include/Protocol/BlockIoCrypto.h
>> index bcc0ed40beff..f15cde32f61b 100644
>> --- a/MdePkg/Include/Protocol/BlockIoCrypto.h
>> +++ b/MdePkg/Include/Protocol/BlockIoCrypto.h
>> @@ -356,7 +356,7 @@ EFI_STATUS
>> @param[in] MediaId The media ID that the read request is
>> for.
>> @param[in] LBA The starting logical block address to
>> read from on
>> the device.
>> - @param[in, out] Token A pointer to the token associated with
>> the transaction.
>> + @param[in,out] Token A pointer to the token associated with
>> the transaction.
>> @param[in] BufferSize The size of the Buffer in bytes. This
>> must be a multiple
>> of the intrinsic block size of the
>> device.
>> @param[out] Buffer A pointer to the destination buffer for
>> the data. The
>> @@ -423,7 +423,7 @@ EFI_STATUS
>> @param[in] MediaId The media ID that the read request is
>> for.
>> @param[in] LBA The starting logical block address to
>> read from on
>> the device.
>> - @param[in, out] Token A pointer to the token associated with
>> the transaction.
>> + @param[in,out] Token A pointer to the token associated with
>> the transaction.
>> @param[in] BufferSize The size of the Buffer in bytes. This
>> must be a multiple
>> of the intrinsic block size of the
>> device.
>> @param[in] Buffer A pointer to the source buffer for the
>> data.
>> @@ -482,7 +482,7 @@ EFI_STATUS
>> will not be signaled.
>>
>> @param[in] This Pointer to the
>> EFI_BLOCK_IO_CRYPTO_PROTOCOL instance.
>> - @param[in, out] Token A pointer to the token associated with
>> the transaction.
>> + @param[in,out] Token A pointer to the token associated with
>> the transaction.
>>
>> @retval EFI_SUCCESS The flush request was queued if Event
>> is not NULL. All
>> outstanding data was written
>> correctly to the device if
>> diff --git a/MdePkg/Include/Protocol/BluetoothHc.h
>> b/MdePkg/Include/Protocol/BluetoothHc.h
>> index d75cb08f8928..29faf36fb7b7 100644
>> --- a/MdePkg/Include/Protocol/BluetoothHc.h
>> +++ b/MdePkg/Include/Protocol/BluetoothHc.h
>> @@ -164,7 +164,7 @@ EFI_STATUS
>> capability.
>>
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_HC_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in
> bytes,
>> of the data buffer
>> + @param[in,out] BufferSize On input, indicates the size, in
> bytes,
>> of the data buffer
>> specified by Buffer. On output,
>> indicates the amount of
>> data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data
>> that will be transmitted to
>> @@ -200,7 +200,7 @@ EFI_STATUS
>> ACL data packet, including Handle, PB flag, BC flag, data length, and
> data.
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_HC_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in
> bytes,
>> of the data buffer
>> + @param[in,out] BufferSize On input, indicates the size, in
> bytes,
>> of the data buffer
>> specified by Buffer. On output,
>> indicates the amount of
>> data actually transferred.
>> @param[out] Buffer A pointer to the buffer of data
>> that will be received from
>> diff --git a/MdePkg/Include/Protocol/BluetoothIo.h
>> b/MdePkg/Include/Protocol/BluetoothIo.h
>> index 620bfbc961cc..b4f6aee73e55 100644
>> --- a/MdePkg/Include/Protocol/BluetoothIo.h
>> +++ b/MdePkg/Include/Protocol/BluetoothIo.h
>> @@ -105,7 +105,7 @@ EFI_STATUS
>> Send L2CAP message (including L2CAP header).
>>
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_IO_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Buffer.
>> + @param[in,out] BufferSize On input, indicates the size, in bytes,
>> of the data buffer specified by Buffer.
>> On output, indicates the amount
>> of data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data that
>> will be transmitted to Bluetooth L2CAP layer.
>> @param[in] Timeout Indicating the transfer should be
>> completed within this time frame. The units are in
>> @@ -212,7 +212,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_IO_PROTOCOL instance.
>> @param[in] Handle A handle created by
>> EFI_BLUETOOTH_IO_PROTOCOL.L2CapConnect indicates which channel to
>> send.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Buffer.
>> + @param[in,out] BufferSize On input, indicates the size, in bytes,
>> of the data buffer specified by Buffer.
>> On output, indicates the amount
>> of data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data that
>> will be transmitted to Bluetooth L2CAP layer.
>> @param[in] Timeout Indicating the transfer should be
>> completed within this time frame. The units are in
>> diff --git a/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> b/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> index 6331e60a8655..2ec8a48fc551 100644
>> --- a/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> +++ b/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> @@ -234,9 +234,9 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] DataSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Data.
>> + @param[in,out] DataSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Data.
>> On output, indicates the amount of
>> data actually returned.
>> - @param[in, out] Data A pointer to the buffer of data that will
>> be returned.
>> + @param[in,out] Data A pointer to the buffer of data that will
>> be returned.
>>
>> @retval EFI_SUCCESS The BluetoothLE configuration data is
>> returned successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following
>> conditions is TRUE:
>> @@ -293,9 +293,9 @@ EFI_STATUS
>> @param[in] This Pointer to the
>> EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> @param[in] BDAddr Remote BluetoothLE device address.
>> - @param[in, out] DataSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Data.
>> + @param[in,out] DataSize On input, indicates the size, in bytes,
> of
>> the data buffer specified by Data.
>> On output, indicates the amount of
>> data actually returned.
>> - @param[in, out] Data A pointer to the buffer of data that will
>> be returned.
>> + @param[in,out] Data A pointer to the buffer of data that will
>> be returned.
>>
>> @retval EFI_SUCCESS The remote BluetoothLE device
>> configuration data is returned successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following
>> conditions is TRUE:
>> @@ -464,7 +464,7 @@ typedef enum {
>> @param[in] BDAddr Remote BluetoothLE device
>> address. For Local device setting, it
>> should be NULL.
>> @param[in] DataType Data type in
>> EFI_BLUETOOTH_LE_SMP_DATA_TYPE.
>> - @param[in, out] DataSize On input, indicates the size, in bytes,
> of
>> the data buffer specified
>> + @param[in,out] DataSize On input, indicates the size, in bytes,
>> of the data buffer specified
>> by Data. On output, indicates the
>> amount of data actually returned.
>> @param[out] Data A pointer to the buffer of data that
>> will be returned.
>>
>> diff --git a/MdePkg/Include/Protocol/CcMeasurement.h
>> b/MdePkg/Include/Protocol/CcMeasurement.h
>> index 4bf21fc42fa0..555356d56d66 100644
>> --- a/MdePkg/Include/Protocol/CcMeasurement.h
>> +++ b/MdePkg/Include/Protocol/CcMeasurement.h
>> @@ -139,7 +139,7 @@ typedef struct {
>> capability information and state information.
>>
>> @param[in] This Indicates the calling context
>> - @param[in, out] ProtocolCapability The caller allocates memory for a
>> EFI_CC_BOOT_SERVICE_CAPABILITY
>> + @param[in,out] ProtocolCapability The caller allocates memory for a
>> EFI_CC_BOOT_SERVICE_CAPABILITY
>> structure and sets the size
>> field to the size of the structure allocated.
>> The callee fills in the fields
>> with the EFI CC BOOT Service capability
>> information and the current
>> CC information.
>> diff --git a/MdePkg/Include/Protocol/CpuIo2.h
>> b/MdePkg/Include/Protocol/CpuIo2.h
>> index 39ddda62bfcf..baddbeb51de5 100644
>> --- a/MdePkg/Include/Protocol/CpuIo2.h
>> +++ b/MdePkg/Include/Protocol/CpuIo2.h
>> @@ -81,7 +81,7 @@ typedef enum {
>> @param[in] Address The base address of the I/O operation.
>> @param[in] Count The number of I/O operations to perform.
>> The number
>> of bytes moved is Width size * Count,
>> starting at Address.
>> - @param[in, out] Buffer For read operations, the destination buffer
> to
>> store the results.
>> + @param[in,out] Buffer For read operations, the destination buffer
>> to store the results.
>> For write operations, the source buffer
>> from which to write data.
>>
>> @retval EFI_SUCCESS The data was read from or written to
>> the PI system.
>> diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h
>> index 37b94b55c998..2c69772225ad 100644
>> --- a/MdePkg/Include/Protocol/Eap.h
>> +++ b/MdePkg/Include/Protocol/Eap.h
>> @@ -54,7 +54,7 @@ typedef VOID *EFI_PORT_HANDLE;
>> @param[in] RequestSize Packet size in bytes for the most
>> recently received
>> EAP-Request packet.
>> @param[in] Buffer Pointer to the buffer to hold the built
>> packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes.
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes.
>> On input, it is the buffer size
>> provided by the caller.
>> On output, it is the buffer size in
>> fact needed to contain
>> the packet.
>> diff --git a/MdePkg/Include/Protocol/EapConfiguration.h
>> b/MdePkg/Include/Protocol/EapConfiguration.h
>> index 6fcddabcb7b2..4bd100677b55 100644
>> --- a/MdePkg/Include/Protocol/EapConfiguration.h
>> +++ b/MdePkg/Include/Protocol/EapConfiguration.h
>> @@ -114,8 +114,8 @@ EFI_STATUS
>> @param[in] This Pointer to the
>> EFI_EAP_CONFIGURATION_PROTOCOL instance.
>> @param[in] EapType EAP type.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] Data Pointer to configuration data.
>> - @param[in, out] DataSize Total size of configuration data. On
>> input, it means
>> + @param[in,out] Data Pointer to configuration data.
>> + @param[in,out] DataSize Total size of configuration data. On
>> input, it means
>> the size of Data buffer. On output,
>> it means the size
>> of copied Data buffer if
>> EFI_SUCCESS, and means the
>> size of desired Data buffer if
>> EFI_BUFFER_TOO_SMALL.
>> diff --git a/MdePkg/Include/Protocol/EapManagement.h
>> b/MdePkg/Include/Protocol/EapManagement.h
>> index ea1b0d71e357..20f915e30cf5 100644
>> --- a/MdePkg/Include/Protocol/EapManagement.h
>> +++ b/MdePkg/Include/Protocol/EapManagement.h
>> @@ -294,7 +294,7 @@ EFI_STATUS
>> instance that indicates the calling
>> context.
>> @param[out] CurrentState Returns the current state of the
>> Supplicant PAE
>> state machine for the Port.
>> - @param[in, out] Configuration Returns the configuration of the
>> operational
>> + @param[in,out] Configuration Returns the configuration of the
>> operational
>> parameters of the Supplicant PAE
>> state machine
>> for the Port as required. This
>> parameter can be
>> NULL to ignore reading the
>> configuration.
>> diff --git a/MdePkg/Include/Protocol/EapManagement2.h
>> b/MdePkg/Include/Protocol/EapManagement2.h
>> index ab42b04e1a04..768f82b6aab2 100644
>> --- a/MdePkg/Include/Protocol/EapManagement2.h
>> +++ b/MdePkg/Include/Protocol/EapManagement2.h
>> @@ -33,10 +33,10 @@ typedef struct
>> _EFI_EAP_MANAGEMENT2_PROTOCOL
>> EFI_EAP_MANAGEMENT2_PROTOCOL;
>> MAC layer driver can use MSK to derive more keys, e.g. PMK (Pairwise
>> Master Key).
>>
>> @param[in] This Pointer to the
>> EFI_EAP_MANAGEMENT2_PROTOCOL instance.
>> - @param[in, out] Msk Pointer to MSK (Master Session Key)
>> buffer.
>> - @param[in, out] MskSize MSK buffer size.
>> - @param[in, out] Emsk Pointer to EMSK (Extended Master
>> Session Key) buffer.
>> - @param[in, out] EmskSize EMSK buffer size.
>> + @param[in,out] Msk Pointer to MSK (Master Session
>> Key) buffer.
>> + @param[in,out] MskSize MSK buffer size.
>> + @param[in,out] Emsk Pointer to EMSK (Extended Master
>> Session Key) buffer.
>> + @param[in,out] EmskSize EMSK buffer size.
>>
>> @retval EFI_SUCCESS The operation completed
>> successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following
>> conditions is TRUE:
>> diff --git a/MdePkg/Include/Protocol/EraseBlock.h
>> b/MdePkg/Include/Protocol/EraseBlock.h
>> index bfa5921400aa..5f71ccdf9a0e 100644
>> --- a/MdePkg/Include/Protocol/EraseBlock.h
>> +++ b/MdePkg/Include/Protocol/EraseBlock.h
>> @@ -45,7 +45,7 @@ typedef struct {
>> @param[in] LBA The starting logical block address
>> to be
>> erased. The caller is responsible
>> for erasing
>> only legitimate locations.
>> - @param[in, out] Token A pointer to the token associated
>> with the
>> + @param[in,out] Token A pointer to the token associated
>> with the
>> transaction.
>> @param[in] Size The size in bytes to be erased. This
>> must be
>> a multiple of the physical block
>> size of the
>> diff --git a/MdePkg/Include/Protocol/FirmwareManagement.h
>> b/MdePkg/Include/Protocol/FirmwareManagement.h
>> index f37067df3455..3bdebc29accd 100644
>> --- a/MdePkg/Include/Protocol/FirmwareManagement.h
>> +++ b/MdePkg/Include/Protocol/FirmwareManagement.h
>> @@ -286,12 +286,12 @@ EFI_STATUS
>> The saved copy could later been used, for example, in firmware image
>> recovery or rollback.
>>
>> @param[in] This A pointer to the
>> EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance.
>> - @param[in, out] ImageInfoSize A pointer to the size, in bytes, of
> the
>> ImageInfo buffer.
>> + @param[in,out] ImageInfoSize A pointer to the size, in bytes, of
>> the ImageInfo buffer.
>> On input, this is the size of the
>> buffer allocated by the caller.
>> On output, it is the size of the
>> buffer returned by the firmware
>> if the buffer was large enough,
>> or the size of the buffer needed
>> to contain the image(s)
>> information if the buffer was too small.
>> - @param[in, out] ImageInfo A pointer to the buffer in which
>> firmware places the current image(s)
>> + @param[in,out] ImageInfo A pointer to the buffer in which
>> firmware places the current image(s)
>> information. The information
>> is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs.
>> @param[out] DescriptorVersion A pointer to the location in which
>> firmware returns the version number
>> associated with the
>> EFI_FIRMWARE_IMAGE_DESCRIPTOR.
>> @@ -340,7 +340,7 @@ EFI_STATUS
>> @param[in] ImageIndex A unique number identifying the
>> firmware image(s) within the device.
>> The number is between 1 and
>> DescriptorCount.
>> @param[out] Image Points to the buffer where the
>> current image is copied to.
>> - @param[in, out] ImageSize On entry, points to the size of the
> buffer
>> pointed to by Image, in bytes.
>> + @param[in,out] ImageSize On entry, points to the size of the
>> buffer pointed to by Image, in bytes.
>> On return, points to the length of
>> the image, in bytes.
>>
>> @retval EFI_SUCCESS The device was successfully updated
>> with the new image.
>> diff --git a/MdePkg/Include/Protocol/I2cEnumerate.h
>> b/MdePkg/Include/Protocol/I2cEnumerate.h
>> index e1890e470c62..be07979043ae 100644
>> --- a/MdePkg/Include/Protocol/I2cEnumerate.h
>> +++ b/MdePkg/Include/Protocol/I2cEnumerate.h
>> @@ -28,7 +28,7 @@ typedef struct _EFI_I2C_ENUMERATE_PROTOCOL
>> EFI_I2C_ENUMERATE_PROTOCOL;
>>
>> @param[in] This The platform data for the next device
>> on
>> the I2C bus was returned
>> successfully.
>> - @param[in, out] Device Pointer to a buffer containing an
>> + @param[in,out] Device Pointer to a buffer containing an
>> EFI_I2C_DEVICE structure.
>> Enumeration is
>> started by setting the initial
>> EFI_I2C_DEVICE
>> structure pointer to NULL. The
>> buffer
>> diff --git a/MdePkg/Include/Protocol/IpSec.h
>> b/MdePkg/Include/Protocol/IpSec.h
>> index 0b5d55a85293..6295bf43d401 100644
>> --- a/MdePkg/Include/Protocol/IpSec.h
>> +++ b/MdePkg/Include/Protocol/IpSec.h
>> @@ -55,11 +55,11 @@ typedef struct _EFI_IPSEC_FRAGMENT_DATA {
>> @param[in] This Pointer to the
>> EFI_IPSEC_PROTOCOL instance.
>> @param[in] NicHandle Instance of the network
>> interface.
>> @param[in] IpVer IPV4 or IPV6.
>> - @param[in, out] IpHead Pointer to the IP Header.
>> + @param[in,out] IpHead Pointer to the IP Header.
>> @param[in] LastHead The protocol of the next layer to
>> be processed by IPsec.
>> @param[in] OptionsBuffer Pointer to the options buffer.
>> @param[in] OptionsLength Length of the options buffer.
>> - @param[in, out] FragmentTable Pointer to a list of fragments.
>> + @param[in,out] FragmentTable Pointer to a list of fragments.
>> @param[in] FragmentCount Number of fragments.
>> @param[in] TrafficDirection Traffic direction.
>> @param[out] RecycleSignal Event for recycling of resources.
>> @@ -111,7 +111,7 @@ struct _EFI_IPSEC_PROTOCOL {
>> @param[in] This Pointer to the
>> EFI_IPSEC2_PROTOCOL instance.
>> @param[in] NicHandle Instance of the network
>> interface.
>> @param[in] IpVer IP version.IPv4 or IPv6.
>> - @param[in, out] IpHead Pointer to the IP Header it is
>> either
>> + @param[in,out] IpHead Pointer to the IP Header it is
>> either
>> the EFI_IP4_HEADER or
>> EFI_IP6_HEADER.
>> On input, it contains the IP
>> header.
>> On output, 1) in tunnel mode
>> and the
>> @@ -123,10 +123,10 @@ struct _EFI_IPSEC_PROTOCOL {
>> mode, the related fielders
>> (like payload
>> length, Next header) in IP
>> header will
>> be modified according to the
>> condition.
>> - @param[in, out] LastHead For IP4, it is the next protocol in
>> IP
>> + @param[in,out] LastHead For IP4, it is the next protocol
>> in IP
>> header. For IP6 it is the Next
>> Header
>> of the last extension header.
>> - @param[in, out] OptionsBuffer On input, it contains the options
>> + @param[in,out] OptionsBuffer On input, it contains the options
>> (extensions header) to be
>> processed by
>> IPsec. On output, 1) in tunnel
>> mode and
>> the traffic direction is
>> outbound, it
>> @@ -143,10 +143,10 @@ struct _EFI_IPSEC_PROTOCOL {
>> might be same with input's.
>> The caller
>> should take the responsibility
>> to free
>> the buffer both on input and
>> on output.
>> - @param[in, out] OptionsLength On input, the input length of the
>> options
>> + @param[in,out] OptionsLength On input, the input length of the
>> options
>> buffer. On output, the output
>> length of
>> the options buffer.
>> - @param[in, out] FragmentTable Pointer to a list of fragments. On
>> input,
>> + @param[in,out] FragmentTable Pointer to a list of fragments.
>> On input,
>> these fragments contain the
>> IP payload.
>> On output, 1) in tunnel mode
>> and the traffic
>> direction is inbound, the
>> fragments contain
>> @@ -167,7 +167,7 @@ struct _EFI_IPSEC_PROTOCOL {
>> payload which encapsulates
>> the next layer
>> protocol information
>> between the encapsulated
>> header and encapsulated
>> trailer fields.
>> - @param[in, out] FragmentCount Number of fragments.
>> + @param[in,out] FragmentCount Number of fragments.
>> @param[in] TrafficDirection Traffic direction.
>> @param[out] RecycleSignal Event for recycling of resources.
>>
>> diff --git a/MdePkg/Include/Protocol/IpSecConfig.h
>> b/MdePkg/Include/Protocol/IpSecConfig.h
>> index 7136060691ca..2c9d3d8ddd45 100644
>> --- a/MdePkg/Include/Protocol/IpSecConfig.h
>> +++ b/MdePkg/Include/Protocol/IpSecConfig.h
>> @@ -647,7 +647,7 @@ EFI_STATUS
>> @param[in] DataType The type of data to retrieve.
>> @param[in] Selector Pointer to an entry selector which is
>> an identifier of the IPsec
>> configuration data entry.
>> - @param[in, out] DataSize On output the size of data returned in
>> Data.
>> + @param[in,out] DataSize On output the size of data returned in
>> Data.
>> @param[out] Data The buffer to return the contents of
>> the IPsec configuration data.
>> The type of the data buffer is
>> associated with the DataType.
>>
>> @@ -692,8 +692,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_IPSEC_CONFIG_PROTOCOL instance.
>> @param[in] DataType The type of IPsec configuration data
>> to retrieve.
>> - @param[in, out] SelectorSize The size of the Selector buffer.
>> - @param[in, out] Selector On input, supplies the pointer to last
>> Selector that was
>> + @param[in,out] SelectorSize The size of the Selector buffer.
>> + @param[in,out] Selector On input, supplies the pointer to last
>> Selector that was
>> returned by GetNextSelector().
>> On output, returns one copy of the
>> current entry Selector
>> of a given DataType.
>> diff --git a/MdePkg/Include/Protocol/Kms.h
>> b/MdePkg/Include/Protocol/Kms.h
>> index c37fcbb65c63..b63e7d2cbd1b 100644
>> --- a/MdePkg/Include/Protocol/Kms.h
>> +++ b/MdePkg/Include/Protocol/Kms.h
>> @@ -366,7 +366,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -379,7 +379,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if and
>> only if the
>> @@ -419,11 +419,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> processed by this operation.
>> On return, this number
>> will be updated with the
>> number of key descriptors
>> successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the
>> keys to be generated.
>> On input, the KeyIdentifierSize
>> and the KeyIdentifier
>> may specify an identifier to be
>> used for the key,
>> @@ -447,7 +447,7 @@ EFI_STATUS
>> type and must be freed by the
>> caller when it is no longer
>> needed. Also, the KeyStatus
>> field must reflect the result
>> of the request relative to that
>> key.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -460,7 +460,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -514,11 +514,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> processed by this operation.
>> On return, this number
>> will be updated with the
>> number of key descriptors
>> successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the
>> keys to be retrieved
>> from the KMS.
>> On input, the KeyIdentifierSize
>> and the KeyIdentifier
>> @@ -533,7 +533,7 @@ EFI_STATUS
>> must be freed by the caller
>> when it is no longer needed.
>> Also, the KeyStatus field will
>> reflect the result of the
>> request relative to the
>> individual key descriptor.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -546,7 +546,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -602,11 +602,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> processed by this operation.
>> On normal return, this
>> number will be updated with
>> the number of key
>> descriptors successfully
>> processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the
>> keys to be added.
>> On input, the KeyId field for
>> first key must contain
>> valid identifier data to be used
>> for adding a key to
>> @@ -619,7 +619,7 @@ EFI_STATUS
>> consistent values to be
>> associated with the given KeyId.
>> On return, the KeyStatus field
>> will reflect the result
>> of the operation for each key
>> request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -632,7 +632,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -688,11 +688,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors to be
>> processed by this operation.
>> On normal return, this
>> number will be updated with
>> the number of key
>> descriptors successfully
>> processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the
>> keys to be deleted.
>> On input, the KeyId field for
>> first key must contain
>> valid identifier data to be used
>> for adding a key to
>> @@ -704,7 +704,7 @@ EFI_STATUS
>> KeyValue fields are ignored,
>> but should be 0.
>> On return, the KeyStatus field
>> will reflect the result
>> of the operation for each key
>> request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -717,7 +717,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -770,19 +770,19 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
>> KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier
>> associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures associated with the
>> Key identifier. If none
>> are found, the count value is
>> zero on return.
>> On input this value reflects
>> the number of KeyAttributes
>> that may be returned.
>> On output, the value reflects
>> the number of completed
>> KeyAttributes structures
>> found.
>> - @param[in, out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures associated with the
>> Key Identifier.
>> On input, the fields in the
>> structure should be NULL.
>> On output, the attribute fields
>> will have updated values
>> for attributes associated with
>> this key identifier.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -795,7 +795,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -858,18 +858,18 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
>> KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier
>> associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures to associate with
>> the Key. On normal returns,
>> this number will be updated
>> with the number of key
>> attributes successfully
>> processed.
>> - @param[in, out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures providing the
>> attribute information to
>> associate with the key.
>> On input, the values for the
>> fields in the structure
>> are completely filled in.
>> On return the
>> KeyAttributeStatus field will reflect the
>> result of the operation for
>> each key attribute request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -882,7 +882,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -948,19 +948,19 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the
>> KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier
>> associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures to associate with
>> the Key.
>> On input, the count value is
>> one or more.
>> On normal returns, this
>> number will be updated with
>> the number of key attributes
>> successfully processed.
>> - @param[in, out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> structures providing the
>> attribute information to
>> associate with the key.
>> On input, the values for the
>> fields in the structure
>> are completely filled in.
>> On return the
>> KeyAttributeStatus field will reflect the
>> result of the operation for
>> each key attribute request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -973,7 +973,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> @@ -1029,23 +1029,23 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid
>> EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyAttributesCount Pointer to a count of the number of
>> key attribute structures
>> + @param[in,out] KeyAttributesCount Pointer to a count of the number of
>> key attribute structures
>> that must be matched for
>> each returned key descriptor.
>> On input the count value is
>> one or more.
>> On normal returns, this
>> number will be updated with
>> the number of key attributes
>> successfully processed.
>> - @param[in, out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of
>> EFI_KMS_KEY_ATTRIBUTE
>> structure to search for.
>> On input, the values for the
>> fields in the structure are
>> completely filled in.
>> On return the
>> KeyAttributeStatus field will reflect the
>> result of the operation for
>> each key attribute request.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors matched
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of
>> key descriptors matched
>> by this operation.
>> On entry, this number will be
>> zero.
>> On return, this number will be
>> updated to the number
>> of key descriptors successfully
>> found.
>> - @param[in, out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of
>> EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the
>> keys from the KMS
>> having the KeyAttribute(s)
>> specified.
>> On input, this pointer will be
>> NULL.
>> @@ -1057,7 +1057,7 @@ EFI_STATUS
>> caller when it is no longer
>> needed. Also, the KeyStatus
>> field of each descriptor will
>> reflect the result of the
>> request relative to that key
>> descriptor.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an
>> arbitrary block of
>> data specified by the
>> ClientData parameter. This
>> parameter may be NULL, in
>> which case the ClientData
>> parameter will be ignored and
>> no data will be
>> @@ -1070,7 +1070,7 @@ EFI_STATUS
>> In all cases, the value upon
>> return to the caller will
>> be the size of the data block
>> returned to the caller,
>> which will be zero if no data is
>> returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary
>> block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an
>> arbitrary block of data of
>> *ClientDataSize that is to be
>> passed directly to the
>> KMS if it supports the use of
>> client data. This
>> parameter may be NULL if
>> and only if the
>> diff --git a/MdePkg/Include/Protocol/MmCommunication2.h
>> b/MdePkg/Include/Protocol/MmCommunication2.h
>> index 1b56320c7fff..86f74d9d2fa8 100644
>> --- a/MdePkg/Include/Protocol/MmCommunication2.h
>> +++ b/MdePkg/Include/Protocol/MmCommunication2.h
>> @@ -28,9 +28,9 @@ typedef struct
>> _EFI_MM_COMMUNICATION2_PROTOCOL
>> EFI_MM_COMMUNICATION2_PROTOCOL;
>> This function provides a service to send and receive messages from a
>> registered UEFI service.
>>
>> @param[in] This The
>> EFI_MM_COMMUNICATION_PROTOCOL instance.
>> - @param[in, out] CommBufferPhysical Physical address of the MM
>> communication buffer
>> - @param[in, out] CommBufferVirtual Virtual address of the MM
>> communication buffer
>> - @param[in, out] CommSize The size of the data buffer being
>> passed in. On exit, the
>> + @param[in,out] CommBufferPhysical Physical address of the MM
>> communication buffer
>> + @param[in,out] CommBufferVirtual Virtual address of the MM
>> communication buffer
>> + @param[in,out] CommSize The size of the data buffer
>> being passed in. On exit, the
>> size of data being returned.
>> Zero if the handler does not
>> wish to reply with any data.
>> This parameter is optional
>> and may be NULL.
>> diff --git a/MdePkg/Include/Protocol/MmSwDispatch.h
>> b/MdePkg/Include/Protocol/MmSwDispatch.h
>> index e7810662ecdb..fdecac020e5e 100644
>> --- a/MdePkg/Include/Protocol/MmSwDispatch.h
>> +++ b/MdePkg/Include/Protocol/MmSwDispatch.h
>> @@ -62,7 +62,7 @@ typedef struct _EFI_MM_SW_DISPATCH_PROTOCOL
>> EFI_MM_SW_DISPATCH_PROTOCOL;
>> @param[in] This Pointer to the
>> EFI_MM_SW_DISPATCH_PROTOCOL instance.
>> @param[in] DispatchFunction Function to register for handler
>> when the specified software
>> MMI is generated.
>> - @param[in, out] RegisterContext Pointer to the dispatch function's
>> context.
>> + @param[in,out] RegisterContext Pointer to the dispatch function's
>> context.
>> The caller fills this context in
>> before calling
>> the register function to indicate
>> to the register
>> function which Software MMI
>> input value the
>> diff --git a/MdePkg/Include/Protocol/Mtftp6.h
>> b/MdePkg/Include/Protocol/Mtftp6.h
>> index 4abf296c1c01..ce5a1409c943 100644
>> --- a/MdePkg/Include/Protocol/Mtftp6.h
>> +++ b/MdePkg/Include/Protocol/Mtftp6.h
>> @@ -368,7 +368,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL
>> instance.
>> @param[in] Token The token provided in the
>> EFI_MTFTP6_PROTOCOL.WriteFile() by the caller.
>> - @param[in, out] Length Indicates the length of the raw data wanted on
>> input, and the
>> + @param[in,out] Length Indicates the length of the raw data wanted
>> on input, and the
>> length the data available on output.
>> @param[out] Buffer Pointer to the buffer where the data is
>> stored.
>>
>> diff --git a/MdePkg/Include/Protocol/Pcd.h b/MdePkg/Include/Protocol/Pcd.h
>> index 25f73cda1423..56c7f03e2c99 100644
>> --- a/MdePkg/Include/Protocol/Pcd.h
>> +++ b/MdePkg/Include/Protocol/Pcd.h
>> @@ -424,7 +424,7 @@ EFI_STATUS
>> If it is not, an error will be returned.
>>
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfBuffer A pointer to the length of the value being
> set
>> for the PCD token.
>> + @param[in,out] SizeOfBuffer A pointer to the length of the value being
>> set for the PCD token.
>> On input, if the SizeOfValue is greater
>> than the maximum size supported
>> for this TokenNumber then the output
>> value of SizeOfValue will reflect
>> the maximum size supported for this
>> TokenNumber.
>> @@ -582,7 +582,7 @@ EFI_STATUS
>>
>> @param[in] Guid The 128-bit unique value that
>> designates the namespace from which to extract the value.
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfBuffer A pointer to the length of the value being
> set
>> for the PCD token.
>> + @param[in,out] SizeOfBuffer A pointer to the length of the value being
>> set for the PCD token.
>> On input, if the SizeOfValue is greater
>> than the maximum size supported
>> for this TokenNumber then the output
>> value of SizeOfValue will reflect
>> the maximum size supported for this
>> TokenNumber.
>> @@ -643,7 +643,7 @@ EFI_STATUS
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being set.
>> @param[in] TokenDataSize The size, in bytes, of the data being set.
>>
>> @retval VOID
>> @@ -737,7 +737,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is
> useful
>> to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token namespace
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token namespace
>> from which the search will start. On
>> output, it designates the next valid token
>> namespace on the platform. If *Guid is
>> NULL, then the GUID of the first token
>> space of the current platform is returned.
>> If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/PiPcd.h
>> b/MdePkg/Include/Protocol/PiPcd.h
>> index e26733b5d9db..63b198c63e0e 100644
>> --- a/MdePkg/Include/Protocol/PiPcd.h
>> +++ b/MdePkg/Include/Protocol/PiPcd.h
>> @@ -379,7 +379,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is
> useful
>> to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token namespace
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it
>> designates a known token namespace
>> from which the search will start. On
>> output, it designates the next valid token
>> namespace on the platform. If *Guid is
>> NULL, then the GUID of the first token
>> space of the current platform is returned.
>> If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/S3SaveState.h
>> b/MdePkg/Include/Protocol/S3SaveState.h
>> index c2b26944fb41..f9f45e0a115a 100644
>> --- a/MdePkg/Include/Protocol/S3SaveState.h
>> +++ b/MdePkg/Include/Protocol/S3SaveState.h
>> @@ -72,7 +72,7 @@ EFI_STATUS
>> in the boot script table
>> specified by Position. If Position is NULL or points to
>> NULL then the new opcode is
>> inserted at the beginning of the table (if TRUE) or end
>> of the table (if FALSE).
>> - @param[in, out] Position On entry, specifies the position in
>> the boot script table where the opcode will be
>> + @param[in,out] Position On entry, specifies the position in
>> the boot script table where the opcode will be
>> inserted, either before or after,
>> depending on BeforeOrAfter. On exit, specifies
>> the position of the inserted
>> opcode in the boot script table.
>> @param[in] OpCode The operation code (opcode)
>> number. See "Related Definitions" in Write() for the
>> @@ -111,7 +111,7 @@ EFI_STATUS
>> NULL then the new label is
>> inserted at the beginning of the table (if TRUE) or end of
>> the table (if FALSE).
>> @param[in] CreateIfNotFound Specifies whether the label will
>> be created if the label does not exists (TRUE) or not (FALSE).
>> - @param[in, out] Position On entry, specifies the position in
>> the boot script table where the label will be inserted,
>> + @param[in,out] Position On entry, specifies the position
>> in the boot script table where the label will be inserted,
>> either before or after,
>> depending on BeforeOrAfter. On exit, specifies the position
>> of the inserted label in the
>> boot script table.
>> @param[in] Label Points to the label which will
>> be inserted in the boot script table.
>> diff --git a/MdePkg/Include/Protocol/Shell.h
>> b/MdePkg/Include/Protocol/Shell.h
>> index 5efee49e197a..413dd0e4acbb 100644
>> --- a/MdePkg/Include/Protocol/Shell.h
>> +++ b/MdePkg/Include/Protocol/Shell.h
>> @@ -734,7 +734,7 @@ EFI_STATUS
>> If there are multiple map names they will be semi-colon seperated in
> the
>> NULL-terminated string.
>>
>> - @param[in, out] DevicePath On entry, points to a device path
> pointer.
>> On
>> + @param[in,out] DevicePath On entry, points to a device path
>> pointer. On
>> exit, updates the pointer to point to
>> the
>> portion of the device path after the
>> mapping.
>>
>> @@ -846,7 +846,7 @@ EFI_STATUS
>> @param[in] Path A pointer to the path string.
>> @param[in] OpenMode Specifies the mode used to open
>> each file, EFI_FILE_MODE_READ or
>> EFI_FILE_MODE_WRITE.
>> - @param[in, out] FileList Points to the start of a list of files
> opened.
>> + @param[in,out] FileList Points to the start of a list of files
>> opened.
>>
>> @retval EFI_SUCCESS Create the file list successfully.
>> @return Can't create the file list.
>> @@ -915,7 +915,7 @@ EFI_STATUS
>>
>> @param[in] FileHandle The opened file handle for read.
>> @param[in] ReadSize On input, the size of Buffer, in bytes.
>> On output, the amount of data read.
>> - @param[in, out] Buffer The buffer in which data is read.
>> + @param[in,out] Buffer The buffer in which data is read.
>>
>> @retval EFI_SUCCESS Data was read.
>> @retval EFI_NO_MEDIA The device has no media.
>> @@ -1157,7 +1157,7 @@ EFI_STATUS
>> Direct writes to opened directories are not supported.
>>
>> @param[in] FileHandle The opened file handle for
>> writing.
>> - @param[in, out] BufferSize On input, size of Buffer.
>> + @param[in,out] BufferSize On input, size of Buffer.
>> @param[in] Buffer The buffer in which data to
>> write.
>>
>> @retval EFI_SUCCESS Data was written.
>> diff --git a/MdePkg/Include/Protocol/SmartCardEdge.h
>> b/MdePkg/Include/Protocol/SmartCardEdge.h
>> index 1251680ec02f..2cf639a32633 100644
>> --- a/MdePkg/Include/Protocol/SmartCardEdge.h
>> +++ b/MdePkg/Include/Protocol/SmartCardEdge.h
>> @@ -225,13 +225,13 @@ extern EFI_GUID gEfiPaddingRsaesOaepGuid;
>>
>> @param[in] This Indicates a pointer to the
>> calling context.
>> @param[out] NumberAidSupported Number of AIDs this
>> protocol supports.
>> - @param[in, out] AidTableSize On input, number of items
>> allocated for the
>> + @param[in,out] AidTableSize On input, number of items
>> allocated for the
>> AID table. On output,
>> number of items returned
>> by protocol.
>> @param[out] AidTable Table of the AIDs supported
>> by the protocol.
>> @param[out] NumberSCPresent Number of currently
>> present Smart Cards that
>> are supported by protocol.
>> - @param[in, out] CsnTableSize On input, the number of items
>> the buffer CSN
>> + @param[in,out] CsnTableSize On input, the number of items
>> the buffer CSN
>> table can contain. On
>> output, the number of
>> items returned by the
>> protocol.
>> @param[out] CsnTable Table of the CSN of the
>> Smart Card present and
>> @@ -343,7 +343,7 @@ EFI_STATUS
>>
>> @param[in] This Indicates a pointer to the calling
>> context.
>> @param[in] SCardHandle Handle on Smart Card
>> connection.
>> - @param[in, out] ReaderNameLength On input, a pointer to the variable
>> that holds
>> + @param[in,out] ReaderNameLength On input, a pointer to the
>> variable that holds
>> the maximal size, in bytes, of
>> ReaderName.
>> On output, the required size, in
>> bytes, for ReaderName.
>> @param[out] ReaderName A pointer to a NULL
>> terminated string that will
>> @@ -455,7 +455,7 @@ EFI_STATUS
>> @param[in] This Indicates a pointer to the calling
>> context.
>> @param[in] SCardHandle Handle on Smart Card connection.
>> @param[in] DataId The type identifier of the data to
>> get.
>> - @param[in, out] DataSize On input, in bytes, the size of Data. On
>> output,
>> + @param[in,out] DataSize On input, in bytes, the size of Data. On
>> output,
>> in bytes, the size of buffer required
>> to store
>> the specified data.
>> @param[out] Data The data buffer in which the data is
>> returned.
>> @@ -507,7 +507,7 @@ EFI_STATUS
>>
>> @param[in] This Indicates a pointer to the calling
>> context.
>> @param[in] SCardHandle Handle on Smart Card connection.
>> - @param[in, out] CredentialSize On input, in bytes, the size of buffer
> to
>> store
>> + @param[in,out] CredentialSize On input, in bytes, the size of buffer
> to
>> store
>> the list of credential.
>> On output, in bytes, the size of
>> buffer required
>> to store the entire list of
>> credentials.
>> @@ -623,7 +623,7 @@ EFI_STATUS
>> -
>> EFI_PADDING_RSAES_OAEP_GUID
>> @param[in] EncryptedSize Size of data to decrypt.
>> @param[in] EncryptedData Data to decrypt
>> - @param[in, out] PlaintextSize On input, in bytes, the size of buffer
> to
>> store
>> + @param[in,out] PlaintextSize On input, in bytes, the size of buffer
> to
>> store
>> the decrypted data.
>> On output, in bytes, the size of
>> buffer required
>> to store the decrypted data.
>> diff --git a/MdePkg/Include/Protocol/SmartCardReader.h
>> b/MdePkg/Include/Protocol/SmartCardReader.h
>> index 0ce117c9c764..a65b40932ec5 100644
>> --- a/MdePkg/Include/Protocol/SmartCardReader.h
>> +++ b/MdePkg/Include/Protocol/SmartCardReader.h
>> @@ -135,13 +135,13 @@ EFI_STATUS
>> @param[in] This Indicates a pointer to the calling
>> context.
>> @param[out] ReaderName A pointer to a NULL terminated
>> string that will
>> contain the reader name.
>> - @param[in, out] ReaderNameLength On input, a pointer to the
>> variablethat holds the
>> + @param[in,out] ReaderNameLength On input, a pointer to the
>> variablethat holds the
>> maximal size, in bytes,of
>> ReaderName.
>> On output, the required size, in
>> bytes, for ReaderName.
>> @param[out] State Current state of the smart card
>> reader.
>> @param[out] CardProtocol Current protocol used to
>> communicate with the smart card.
>> @param[out] Atr A pointer to retrieve the ATR of
>> the smart card.
>> - @param[in, out] AtrLength On input, a pointer to hold the
>> maximum size, in bytes,
>> + @param[in,out] AtrLength On input, a pointer to hold the
>> maximum size, in bytes,
>> of Atr(usually 33).
>> On output, the required size,
>> inbytes, for the smart
>> card ATR.
>> @@ -184,7 +184,7 @@ EFI_STATUS
>> @param[in] CAPDULength Command APDU size, in bytes.
>> @param[out] RAPDU A pointer to a byte array that will
>> contain the
>> Response APDU.
>> - @param[in, out] RAPDULength On input, the maximum size, inbytes, of
>> the Response
>> + @param[in,out] RAPDULength On input, the maximum size, inbytes,
>> of the Response
>> APDU.
>> On output, the size, in bytes, of the
>> Response APDU.
>>
>> @@ -226,7 +226,7 @@ EFI_STATUS
>> @param[in] InBuffer A pointer to the input parameters.
>> @param[in] InBufferLength Size, in bytes, of input parameters.
>> @param[out] OutBuffer A pointer to the output
>> parameters.
>> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to
>> store output
>> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to
>> store output
>> parameters.
>> On output, the size, in bytes, of
>> output parameters.
>>
>> @@ -271,7 +271,7 @@ EFI_STATUS
>> @param[in] Attrib Identifier for the attribute to
>> retrieve.
>> @param[out] OutBuffer A pointer to a buffer that will
>> contain
>> attribute data.
>> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to
>> store
>> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to
>> store
>> attribute data.
>> On output, the size, in bytes, of
>> attribute
>> data.
>> diff --git a/MdePkg/Include/Protocol/Smbios.h
>> b/MdePkg/Include/Protocol/Smbios.h
>> index f9346aac7224..83e8065f6fa3 100644
>> --- a/MdePkg/Include/Protocol/Smbios.h
>> +++ b/MdePkg/Include/Protocol/Smbios.h
>> @@ -97,7 +97,7 @@ typedef struct _EFI_SMBIOS_PROTOCOL
>> EFI_SMBIOS_PROTOCOL;
>>
>> @param[in] This The
>> EFI_SMBIOS_PROTOCOL instance.
>> @param[in] ProducerHandle The handle of the controller
>> or driver associated with the SMBIOS information. NULL means no handle.
>> - @param[in, out] SmbiosHandle On entry, the handle of the
>> SMBIOS record to add. If FFFEh, then a unique handle
>> + @param[in,out] SmbiosHandle On entry, the handle of the
>> SMBIOS record to add. If FFFEh, then a unique handle
>> will be assigned to the
>> SMBIOS record. If the SMBIOS handle is already in use,
>> EFI_ALREADY_STARTED is
>> returned and the SMBIOS record is not updated.
>> @param[in] Record The data for the fixed
>> portion of the SMBIOS record. The format of the record is
>> @@ -168,7 +168,7 @@ EFI_STATUS
>> only the SMBIOS records that match the optional Type argument.
>>
>> @param[in] This The EFI_SMBIOS_PROTOCOL
>> instance.
>> - @param[in, out] SmbiosHandle On entry, points to the previous
>> handle of the SMBIOS record. On exit, points to the
>> + @param[in,out] SmbiosHandle On entry, points to the previous
>> handle of the SMBIOS record. On exit, points to the
>> next SMBIOS record handle. If
>> it is FFFEh on entry, then the first SMBIOS record
>> handle will be returned. If it
>> returns FFFEh on exit, then there are no more SMBIOS records.
>> @param[in] Type On entry, it points to the type of
>> the next SMBIOS record to return. If NULL, it
>> diff --git a/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> b/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> index d0db953f06b0..27e91b5fb80f 100644
>> --- a/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> +++ b/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> @@ -60,7 +60,7 @@ typedef struct _EFI_SMM_SW_DISPATCH2_PROTOCOL
>> EFI_SMM_SW_DISPATCH2_PROTOCOL;
>> @param[in] This Pointer to the
>> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
>> @param[in] DispatchFunction Function to register for handler
>> when the specified software
>> SMI is generated.
>> - @param[in, out] RegisterContext Pointer to the dispatch function's
>> context.
>> + @param[in,out] RegisterContext Pointer to the dispatch function's
>> context.
>> The caller fills this context in
>> before calling
>> the register function to indicate
>> to the register
>> function which Software SMI
>> input value the
>> diff --git a/MdePkg/Include/Protocol/SuperIo.h
>> b/MdePkg/Include/Protocol/SuperIo.h
>> index 802615030c91..bc7655e27281 100644
>> --- a/MdePkg/Include/Protocol/SuperIo.h
>> +++ b/MdePkg/Include/Protocol/SuperIo.h
>> @@ -45,7 +45,7 @@ typedef struct _EFI_SIO_PROTOCOL
>> EFI_SIO_PROTOCOL;
>> The Super I/O driver must track the
>> current state of the Super I/O and enable the
>> configuration mode of Super I/O if
>> necessary prior to register access.
>> @param[in] Register Register number.
>> - @param[in, out] Value If Write is TRUE, Value is a pointer to
>> the buffer containing the byte of data to be
>> + @param[in,out] Value If Write is TRUE, Value is a pointer to
>> the buffer containing the byte of data to be
>> written to the Super I/O register. If
>> Write is FALSE, Value is a pointer to the
>> destination buffer for the byte of
>> data to be read from the Super I/O register.
>>
>> diff --git a/MdePkg/Include/Protocol/Supplicant.h
>> b/MdePkg/Include/Protocol/Supplicant.h
>> index d78622112583..0c44673482b5 100644
>> --- a/MdePkg/Include/Protocol/Supplicant.h
>> +++ b/MdePkg/Include/Protocol/Supplicant.h
>> @@ -311,7 +311,7 @@ typedef struct {
>> RequestBuffer is NULL.
>> @param[out] Buffer Pointer to the buffer to hold the
>> built
>> packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
>> input, it is the buffer size provided
>> by the
>> caller. On output, it is the buffer
>> size in
>> fact needed to contain the
>> packet.
>> @@ -347,7 +347,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_SUPPLICANT_PROTOCOL
>> instance.
>> - @param[in, out] FragmentTable Pointer to a list of fragment. The
>> caller
>> + @param[in,out] FragmentTable Pointer to a list of fragment. The
>> caller
>> will take responsible to handle
>> the original
>> FragmentTable while it may be
>> reallocated in
>> Supplicant driver.
>> @@ -410,7 +410,7 @@ EFI_STATUS
>> @param[in] DataType The type of data.
>> @param[out] Data Pointer to the buffer to hold the
>> data.
>> Ignored if DataSize is 0.
>> - @param[in, out] DataSize Pointer to the buffer size in bytes. On
>> + @param[in,out] DataSize Pointer to the buffer size in bytes.
>> On
>> input, it is the buffer size provided
>> by the
>> caller. On output, it is the buffer
>> size in
>> fact needed to contain the
>> packet.
>> diff --git a/MdePkg/Include/Protocol/Tcg2Protocol.h
>> b/MdePkg/Include/Protocol/Tcg2Protocol.h
>> index f1326a5ef022..7199b6407666 100644
>> --- a/MdePkg/Include/Protocol/Tcg2Protocol.h
>> +++ b/MdePkg/Include/Protocol/Tcg2Protocol.h
>> @@ -143,7 +143,7 @@ typedef struct tdEFI_TCG2_EVENT {
>> capability information and state information.
>>
>> @param[in] This Indicates the calling context
>> - @param[in, out] ProtocolCapability The caller allocates memory for a
>> EFI_TCG2_BOOT_SERVICE_CAPABILITY
>> + @param[in,out] ProtocolCapability The caller allocates memory for a
>> EFI_TCG2_BOOT_SERVICE_CAPABILITY
>> structure and sets the size
>> field to the size of the structure allocated.
>> The callee fills in the fields
>> with the EFI protocol capability information
>> and the current EFI TCG2 state
>> information up to the number of fields which
>> diff --git a/MdePkg/Include/Protocol/Tls.h b/MdePkg/Include/Protocol/Tls.h
>> index edcf0e3e728c..24c902530b44 100644
>> --- a/MdePkg/Include/Protocol/Tls.h
>> +++ b/MdePkg/Include/Protocol/Tls.h
>> @@ -376,8 +376,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_TLS_PROTOCOL
>> instance.
>> @param[in] DataType TLS session data type.
>> - @param[in, out] Data Pointer to session data.
>> - @param[in, out] DataSize Total size of session data. On input,
> it
>> means
>> + @param[in,out] Data Pointer to session data.
>> + @param[in,out] DataSize Total size of session data. On input,
> it
>> means
>> the size of Data buffer. On output,
>> it means the size
>> of copied Data buffer if
>> EFI_SUCCESS, and means the
>> size of desired Data buffer if
>> EFI_BUFFER_TOO_SMALL.
>> @@ -422,7 +422,7 @@ EFI_STATUS
>> @param[in] RequestSize Packet size in bytes for the most
>> recently received TLS
>> packet. 0 is only valid when
>> RequestBuffer is NULL.
>> @param[out] Buffer Pointer to the buffer to hold the
>> built packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
>> input, it is
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
>> input, it is
>> the buffer size provided by the
>> caller. On output, it
>> is the buffer size in fact needed to
>> contain the
>> packet.
>> @@ -456,7 +456,7 @@ EFI_STATUS
>> The ProcessPacket () function process each inbound or outbound TLS APP
>> packet.
>>
>> @param[in] This Pointer to the EFI_TLS_PROTOCOL
>> instance.
>> - @param[in, out] FragmentTable Pointer to a list of fragment. The
>> caller will take
>> + @param[in,out] FragmentTable Pointer to a list of fragment. The
>> caller will take
>> responsible to handle the original
>> FragmentTable while
>> it may be reallocated in TLS driver.
>> If CryptMode is
>> EfiTlsEncrypt, on input these
>> fragments contain the TLS
>> diff --git a/MdePkg/Include/Protocol/TlsConfig.h
>> b/MdePkg/Include/Protocol/TlsConfig.h
>> index 8b2a94d41f8e..9b9019338757 100644
>> --- a/MdePkg/Include/Protocol/TlsConfig.h
>> +++ b/MdePkg/Include/Protocol/TlsConfig.h
>> @@ -87,8 +87,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the
>> EFI_TLS_CONFIGURATION_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] Data Pointer to configuration data.
>> - @param[in, out] DataSize Total size of configuration data. On
>> input, it means
>> + @param[in,out] Data Pointer to configuration data.
>> + @param[in,out] DataSize Total size of configuration data. On
>> input, it means
>> the size of Data buffer. On output,
>> it means the size
>> of copied Data buffer if
>> EFI_SUCCESS, and means the
>> size of desired Data buffer if
>> EFI_BUFFER_TOO_SMALL.
>> diff --git a/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> b/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> index 34676c7831c5..ae0253ae4f64 100644
>> --- a/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> +++ b/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> @@ -34,8 +34,8 @@ typedef struct _EFI_UFS_DEVICE_CONFIG_PROTOCOL
>> EFI_UFS_DEVICE_CONFIG_PROTOCOL;
>> @param[in] DescId The ID of device descriptor.
>> @param[in] Index The Index of device descriptor.
>> @param[in] Selector The Selector of device descriptor.
>> - @param[in, out] Descriptor The buffer of device descriptor to be
> read
>> or written.
>> - @param[in, out] DescSize The size of device descriptor buffer. On
>> input, the size, in bytes,
>> + @param[in,out] Descriptor The buffer of device descriptor to be
>> read or written.
>> + @param[in,out] DescSize The size of device descriptor buffer. On
>> input, the size, in bytes,
>> of the data buffer specified by
>> Descriptor. On output, the number
>> of bytes that were actually
>> transferred.
>>
>> @@ -68,7 +68,7 @@ EFI_STATUS
>> @param[in] This The pointer to the
>> EFI_UFS_DEVICE_CONFIG_PROTOCOL instance.
>> @param[in] Read The boolean variable to show r/w
>> direction.
>> @param[in] FlagId The ID of flag to be read or written.
>> - @param[in, out] Flag The buffer to set or clear flag.
>> + @param[in,out] Flag The buffer to set or clear flag.
>>
>> @retval EFI_SUCCESS The flag descriptor is set/clear
>> successfully.
>> @retval EFI_INVALID_PARAMETER This is NULL or Flag is NULL.
>> @@ -96,8 +96,8 @@ EFI_STATUS
>> @param[in] AttrId The ID of Attribute.
>> @param[in] Index The Index of Attribute.
>> @param[in] Selector The Selector of Attribute.
>> - @param[in, out] Attribute The buffer of Attribute to be read or
>> written.
>> - @param[in, out] AttrSize The size of Attribute buffer. On input,
> the
>> size, in bytes, of the
>> + @param[in,out] Attribute The buffer of Attribute to be read or
>> written.
>> + @param[in,out] AttrSize The size of Attribute buffer. On input,
>> the size, in bytes, of the
>> data buffer specified by Attribute.
>> On output, the number of bytes
>> that were actually transferred.
>>
>> diff --git a/MdePkg/Include/Protocol/UsbFunctionIo.h
>> b/MdePkg/Include/Protocol/UsbFunctionIo.h
>> index e360b604808e..3b0fcba69806 100644
>> --- a/MdePkg/Include/Protocol/UsbFunctionIo.h
>> +++ b/MdePkg/Include/Protocol/UsbFunctionIo.h
>> @@ -343,7 +343,7 @@ EFI_STATUS
>> @param[in] This A pointer to the
>> EFI_USBFN_IO_PROTOCOL instance.
>> @param[in] EndpointIndex Indicates the endpoint.
>> @param[in] Direction Direction of the endpoint.
>> - @param[in, out] State Boolean, true value indicates that the
>> endpoint
>> + @param[in,out] State Boolean, true value indicates that the
>> endpoint
>> is in a stalled state, false otherwise.
>>
>> @retval EFI_SUCCESS The function returned successfully.
>> @@ -402,7 +402,7 @@ EFI_STATUS
>>
>> @param[in] This A pointer to the
>> EFI_USBFN_IO_PROTOCOL instance.
>> @param[out] Message Indicates the event that initiated this
>> notification.
>> - @param[in, out] PayloadSize On input, the size of the memory pointed
>> by
>> + @param[in,out] PayloadSize On input, the size of the memory
>> pointed by
>> Payload. On output, the amount
>> ofdata returned
>> in Payload.
>> @param[out] Payload A pointer to
>> EFI_USBFN_MESSAGE_PAYLOAD instance
>> @@ -446,14 +446,14 @@ EFI_STATUS
>> @param[in] EndpointIndex Indicates the endpoint on which TX or
>> RX transfer
>> needs to take place.
>> @param[in] Direction Direction of the endpoint.
>> - @param[in, out] BufferSize If Direction is
>> EfiUsbEndpointDirectionDeviceRx:
>> + @param[in,out] BufferSize If Direction is
>> EfiUsbEndpointDirectionDeviceRx:
>> On input, the size of the Bufferin
>> bytes.
>> On output, the amount of data
>> returned in Buffer
>> in bytes.
>> If Direction is
>> EfiUsbEndpointDirectionDeviceTx:
>> On input, the size of the Bufferin
>> bytes.
>> On output, the amount of data
>> transmitted in bytes.
>> - @param[in, out] Buffer If Direction is
>> EfiUsbEndpointDirectionDeviceRx:
>> + @param[in,out] Buffer If Direction is
>> EfiUsbEndpointDirectionDeviceRx:
>> The Buffer to return the received
>> data.
>> If Directionis
>> EfiUsbEndpointDirectionDeviceTx:
>> The Buffer that contains the data
>> to be transmitted.
>> @@ -630,9 +630,9 @@ EFI_STATUS
>> @param[in] Direction Direction of the endpoint.
>> @param[in] PolicyType Policy type the user is trying to
>> retrieve for
>> the specified non-control endpoint.
>> - @param[in, out] BufferSize On input, the size of Bufferin bytes. On
>> output,
>> + @param[in,out] BufferSize On input, the size of Bufferin bytes. On
>> output,
>> the amount of data returned in
>> Bufferin bytes.
>> - @param[in, out] Buffer A pointer to a buffer to return requested
>> endpoint
>> + @param[in,out] Buffer A pointer to a buffer to return
>> requested endpoint
>> policy value.
>>
>> @retval EFI_SUCCESS The function returned successfully.
>> diff --git a/MdePkg/Include/Protocol/UserCredential.h
>> b/MdePkg/Include/Protocol/UserCredential.h
>> index 986cf44994f1..d1d957330493 100644
>> --- a/MdePkg/Include/Protocol/UserCredential.h
>> +++ b/MdePkg/Include/Protocol/UserCredential.h
>> @@ -83,10 +83,10 @@ EFI_STATUS
>> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is
>> returned.
>>
>> @param[in] This Points to this instance of the
>> EFI_USER_CREDENTIAL_PROTOCOL.
>> - @param[in, out] Width On entry, points to the desired bitmap
>> width. If NULL then no bitmap
>> + @param[in,out] Width On entry, points to the desired
>> bitmap width. If NULL then no bitmap
>> information will be returned. On
>> exit, points to the width of the
>> bitmap returned.
>> - @param[in, out] Height On entry, points to the desired bitmap
>> height. If NULL then no bitmap
>> + @param[in,out] Height On entry, points to the desired
>> bitmap height. If NULL then no bitmap
>> information will be returned. On
>> exit, points to the height of the
>> bitmap returned
>> @param[out] Hii On return, holds the HII database
>> handle.
>> diff --git a/MdePkg/Include/Protocol/UserCredential2.h
>> b/MdePkg/Include/Protocol/UserCredential2.h
>> index fc64ba544a2b..caec534d61ef 100644
>> --- a/MdePkg/Include/Protocol/UserCredential2.h
>> +++ b/MdePkg/Include/Protocol/UserCredential2.h
>> @@ -81,10 +81,10 @@ EFI_STATUS
>> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is
>> returned.
>>
>> @param[in] This Points to this instance of the
>> EFI_USER_CREDENTIAL2_PROTOCOL.
>> - @param[in, out] Width On entry, points to the desired bitmap
>> width. If NULL then no bitmap
>> + @param[in,out] Width On entry, points to the desired
>> bitmap width. If NULL then no bitmap
>> information will be returned. On
>> exit, points to the width of the
>> bitmap returned.
>> - @param[in, out] Height On entry, points to the desired bitmap
>> height. If NULL then no bitmap
>> + @param[in,out] Height On entry, points to the desired
>> bitmap height. If NULL then no bitmap
>> information will be returned. On
>> exit, points to the height of the
>> bitmap returned
>> @param[out] Hii On return, holds the HII database
>> handle.
>> diff --git a/MdePkg/Include/Uefi/UefiSpec.h
>> b/MdePkg/Include/Uefi/UefiSpec.h
>> index 7dfe35b4990b..516f4222d480 100644
>> --- a/MdePkg/Include/Uefi/UefiSpec.h
>> +++ b/MdePkg/Include/Uefi/UefiSpec.h
>> @@ -169,7 +169,7 @@ typedef struct {
>> 0x80000000..0xFFFFFFFF are
>> reserved for use by UEFI OS loaders
>> that are provided by operating
>> system vendors.
>> @param[in] Pages The number of contiguous 4 KB pages
>> to allocate.
>> - @param[in, out] Memory The pointer to a physical address. On
>> input, the way in which the address is
>> + @param[in,out] Memory The pointer to a physical address. On
>> input, the way in which the address is
>> used depends on the value of Type.
>>
>> @retval EFI_SUCCESS The requested pages were allocated.
>> @@ -214,7 +214,7 @@ EFI_STATUS
>> /**
>> Returns the current memory map.
>>
>> - @param[in, out] MemoryMapSize A pointer to the size, in
>> bytes, of the MemoryMap buffer.
>> + @param[in,out] MemoryMapSize A pointer to the size, in
>> bytes, of the MemoryMap buffer.
>> On input, this is the size
>> of the buffer allocated by the caller.
>> On output, it is the size of
>> the buffer returned by the firmware if
>> the buffer was large
>> enough, or the size of the buffer needed to contain
>> @@ -391,7 +391,7 @@ EFI_STATUS
>> Determines the new virtual address that is to be used on subsequent
>> memory accesses.
>>
>> @param[in] DebugDisposition Supplies type information for the
>> pointer being converted.
>> - @param[in, out] Address A pointer to a pointer that is to be
>> fixed to be the value needed
>> + @param[in,out] Address A pointer to a pointer that is to
>> be fixed to be the value needed
>> for the new virtual address
>> mappings being applied.
>>
>> @retval EFI_SUCCESS The pointer pointed to by Address was
>> modified.
>> @@ -650,7 +650,7 @@ VOID
>> @param[in] VendorGuid A unique identifier for the vendor.
>> @param[out] Attributes If not NULL, a pointer to the memory
>> location to return the
>> attributes bitmask for the variable.
>> - @param[in, out] DataSize On input, the size in bytes of the
> return
>> Data buffer.
>> + @param[in,out] DataSize On input, the size in bytes of the
>> return Data buffer.
>> On output the size of data returned
>> in Data.
>> @param[out] Data The buffer to return the contents of
>> the variable. May be NULL
>> with a zero DataSize in order to
>> determine the size buffer needed.
>> @@ -679,12 +679,12 @@ EFI_STATUS
>> /**
>> Enumerates the current variable names.
>>
>> - @param[in, out] VariableNameSize The size of the VariableName buffer.
>> The size must be large
>> + @param[in,out] VariableNameSize The size of the VariableName buffer.
>> The size must be large
>> enough to fit input string
>> supplied in VariableName buffer.
>> - @param[in, out] VariableName On input, supplies the last
>> VariableName that was returned
>> + @param[in,out] VariableName On input, supplies the last
>> VariableName that was returned
>> by GetNextVariableName(). On
>> output, returns the Nullterminated
>> string of the current variable.
>> - @param[in, out] VendorGuid On input, supplies the last
>> VendorGuid that was returned by
>> + @param[in,out] VendorGuid On input, supplies the last
>> VendorGuid that was returned by
>> GetNextVariableName(). On
>> output, returns the
>> VendorGuid of the current
>> variable.
>>
>> @@ -1155,7 +1155,7 @@ typedef enum {
>> InstallMultipleProtocolInterfaces() be used in place of
>> InstallProtocolInterface()
>>
>> - @param[in, out] Handle A pointer to the EFI_HANDLE on
>> which the interface is to be installed.
>> + @param[in,out] Handle A pointer to the EFI_HANDLE on
>> which the interface is to be installed.
>> @param[in] Protocol The numeric ID of the protocol
>> interface.
>> @param[in] InterfaceType Indicates whether Interface is
>> supplied in native form.
>> @param[in] Interface A pointer to the protocol interface.
>> @@ -1180,7 +1180,7 @@ EFI_STATUS
>> /**
>> Installs one or more protocol interfaces into the boot services
>> environment.
>>
>> - @param[in, out] Handle The pointer to a handle to install the
>> new protocol interfaces on,
>> + @param[in,out] Handle The pointer to a handle to install the
>> new protocol interfaces on,
>> or a pointer to NULL if a new handle
>> is to be allocated.
>> @param ... A variable argument list containing
>> pairs of protocol GUIDs and protocol
>> interfaces.
>> @@ -1479,7 +1479,7 @@ typedef enum {
>> @param[in] SearchType Specifies which handle(s) are to be
>> returned.
>> @param[in] Protocol Specifies the protocol to search by.
>> @param[in] SearchKey Specifies the search key.
>> - @param[in, out] BufferSize On input, the size in bytes of Buffer. On
>> output, the size in bytes of
>> + @param[in,out] BufferSize On input, the size in bytes of Buffer. On
>> output, the size in bytes of
>> the array returned in Buffer (if the
>> buffer was large enough) or the
>> size, in bytes, of the buffer needed
>> to obtain the array (if the buffer was
>> not large enough).
>> @@ -1509,7 +1509,7 @@ EFI_STATUS
>> Locates the handle to a device on the device path that supports the
>> specified protocol.
>>
>> @param[in] Protocol Specifies the protocol to search for.
>> - @param[in, out] DevicePath On input, a pointer to a pointer to the
>> device path. On output, the device
>> + @param[in,out] DevicePath On input, a pointer to a pointer to the
>> device path. On output, the device
>> path pointer is modified to point to
>> the remaining part of the device
>> path.
>> @param[out] Device A pointer to the returned device
>> handle.
>> diff --git
>> a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
>> b.c
>> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
>> b.c
>> index e6f479b829f6..dfdee0b5d2c0 100644
>> ---
>> a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
>> b.c
>> +++
>> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLi
>> b.c
>> @@ -28,7 +28,7 @@ typedef struct {
>> the registered guid and Handler list. When it is initialized, it will
> be directly
>> returned.
>> Or, HandlerInfo table will be initialized in this function.
>>
>> - @param[in, out] InfoPointer The pointer to the handler information
>> structure.
>> + @param[in,out] InfoPointer The pointer to the handler information
>> structure.
>>
>> @retval RETURN_SUCCESS HandlerInfo table can be
>> used to store guid and function tables.
>> @retval RETURN_OUT_OF_RESOURCES HandlerInfo table address is
>> not writable.
>> diff --git a/MdePkg/Library/BaseLib/QuickSort.c
>> b/MdePkg/Library/BaseLib/QuickSort.c
>> index d9f0e9a0f475..a7b7d0c6cd2b 100644
>> --- a/MdePkg/Library/BaseLib/QuickSort.c
>> +++ b/MdePkg/Library/BaseLib/QuickSort.c
>> @@ -22,7 +22,7 @@
>>
>> if Count is < 2 then perform no action.
>>
>> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted)
>> elements
>> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted)
>> elements
>> on return a buffer of sorted
>> elements
>> @param[in] Count the number of elements in the
>> buffer to sort
>> @param[in] ElementSize Size of an element in bytes
>> diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> b/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> index a214371c3fdf..39303cf429a7 100644
>> --- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> +++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> @@ -470,7 +470,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -645,7 +645,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set
>> a value from.
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -819,7 +819,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer that was set.
>> @@ -870,7 +870,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> @@ -923,7 +923,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -979,7 +979,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> index 417096f33493..63339fb4a627 100644
>> --- a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> +++ b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> @@ -14,8 +14,8 @@
>> instruction sets.
>>
>> @param[in] Reloc Pointer to the relocation record.
>> - @param[in, out] Fixup Pointer to the address to fix up.
>> - @param[in, out] FixupData Pointer to a buffer to log the fixups.
>> + @param[in,out] Fixup Pointer to the address to fix up.
>> + @param[in,out] FixupData Pointer to a buffer to log the fixups.
>> @param[in] Adjust The offset to adjust the fixup.
>>
>> @return Status code.
>> @@ -117,8 +117,8 @@ PeCoffLoaderImageFormatSupported (
>> space for runtime calls.
>>
>> @param[in] Reloc The pointer to the relocation record.
>> - @param[in, out] Fixup The pointer to the address to fix up.
>> - @param[in, out] FixupData The pointer to a buffer to log the fixups.
>> + @param[in,out] Fixup The pointer to the address to fix up.
>> + @param[in,out] FixupData The pointer to a buffer to log the fixups.
>> @param[in] Adjust The offset to adjust the fixup.
>>
>> @return Status code.
>> diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> b/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> index b2a8bf22a365..c371f26f24c1 100644
>> --- a/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> +++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> @@ -554,7 +554,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -731,7 +731,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set
>> a value from.
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -926,7 +926,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -977,7 +977,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> @@ -1030,7 +1030,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -1086,7 +1086,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> diff --git
>> a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> index c538f157a242..2436e2c8f62e 100644
>> ---
>> a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> +++
>> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> @@ -28,7 +28,7 @@ typedef struct {
>> Build guid hob for the global memory to store the registered guid and
>> Handler list.
>> If GuidHob exists, HandlerInfo will be directly got from Guid hob data.
>>
>> - @param[in, out] InfoPointer The pointer to pei handler information
>> structure.
>> + @param[in,out] InfoPointer The pointer to pei handler information
>> structure.
>>
>> @retval RETURN_SUCCESS Build Guid hob for the global
>> memory space to store guid and function tables.
>> @retval RETURN_OUT_OF_RESOURCES No enough memory to
>> allocated.
>> diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> index 166d4a6f32d0..f16c1f8715a0 100644
>> --- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> +++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> @@ -544,7 +544,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -721,7 +721,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set
>> a value from.
>> @param[in] TokenNumber The PCD token number to set a
>> current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -918,7 +918,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -969,7 +969,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a
>> module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> @@ -1022,7 +1022,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -1078,7 +1078,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of
>> PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the
>> PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of
> Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set
>> the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> b/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> index ad4bfff68c8a..070a0c4f7b2a 100644
>> --- a/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> +++ b/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> @@ -155,9 +155,9 @@ SmmIsMmioValid (
>> /**
>> Merge continuous entries whose type is
>> EfiGcdMemoryTypeMemoryMappedIo.
>>
>> - @param[in, out] GcdMemoryMap A pointer to the buffer in
>> which firmware places
>> + @param[in,out] GcdMemoryMap A pointer to the buffer
>> in which firmware places
>> the current GCD
>> memory map.
>> - @param[in, out] NumberOfDescriptors A pointer to the number of
>> the
>> + @param[in,out] NumberOfDescriptors A pointer to the number of
>> the
>> GcdMemoryMap buffer.
>> On input, this is the number of
>> the current GCD
>> memory map. On output,
>> it is the number of new
>> GCD memory map after merge.
>> diff --git a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> index ff143f00ab9a..1ba604b0cdda 100644
>> --- a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> +++ b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> @@ -723,7 +723,7 @@ PeriodicSmiDispatchFunctionOnCpu (
>> released to notify the CPU that is running the SMM Foundation that the
>> periodic
>> SMI handler execution has finished its execution.
>>
>> - @param[in, out] Buffer A pointer to the context for the periodic SMI
>> handler.
>> + @param[in,out] Buffer A pointer to the context for the periodic SMI
>> handler.
>>
>> **/
>> VOID
>> @@ -758,10 +758,10 @@ PeriodicSmiDispatchFunctionWithLock (
>> SmiHandlerRegister().
>> @param[in] Context Points to an optional handler
>> context which was
>> specified when the handler was
>> registered.
>> - @param[in, out] CommBuffer A pointer to a collection of data in
>> memory that
>> + @param[in,out] CommBuffer A pointer to a collection of data in
>> memory that
>> will be conveyed from a non-SMM
>> environment into
>> an SMM environment.
>> - @param[in, out] CommBufferSize The size of the CommBuffer.
>> + @param[in,out] CommBufferSize The size of the CommBuffer.
>>
>> @retval EFI_SUCCESS The interrupt was
>> handled and quiesced.
>> No other handlers
>> should still be called.
>> @@ -863,7 +863,7 @@ PeriodicSmiDispatchFunction (
>> /**
>> This function enables a periodic SMI handler.
>>
>> - @param[in, out] DispatchHandle A pointer to the handle associated
>> with the
>> + @param[in,out] DispatchHandle A pointer to the handle associated
>> with the
>> enabled periodic SMI handler.
>> This is an
>> optional parameter that may be
>> NULL. If it is
>> NULL, then the handle will not
>> be returned,
>> diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> index 86678e965d99..8fe52cab316f 100644
>> --- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> +++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> @@ -697,8 +697,8 @@ FileHandleSetSize (
>> if Destination's current length (including NULL terminator) is already
> more
>> then
>> CurrentSize, then ASSERT()
>>
>> - @param[in, out] Destination The String to append onto
>> - @param[in, out] CurrentSize on call the number of bytes in
> Destination.
>> On
>> + @param[in,out] Destination The String to append onto
>> + @param[in,out] CurrentSize on call the number of bytes in
>> Destination. On
>> return possibly the new size (still in
>> bytes). if NULL
>> then allocate whatever is needed.
>> @param[in] Source The String to append from
>> @@ -907,7 +907,7 @@ FileHandleGetFileName (
>> maintained and not changed for all operations with the same file.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Ascii Boolean value for indicating whether
>> the file is Ascii (TRUE) or UCS2 (FALSE);
>> + @param[in,out] Ascii Boolean value for indicating whether
>> the file is Ascii (TRUE) or UCS2 (FALSE);
>>
>> @return The line of text from the file.
>>
>> @@ -951,15 +951,15 @@ FileHandleReturnLine (
>> read a CHAR_NULL character will be returned in buffer.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Buffer The pointer to buffer to read into.
>> - @param[in, out] Size The pointer to number of bytes in
>> Buffer.
>> + @param[in,out] Buffer The pointer to buffer to read into.
>> + @param[in,out] Size The pointer to number of bytes in
>> Buffer.
>> @param[in] Truncate If the buffer is large enough, this has
>> no effect.
>> If the buffer is is too small and
>> Truncate is TRUE,
>> the line will be truncated.
>> If the buffer is is too small and
>> Truncate is FALSE,
>> then no read will occur.
>>
>> - @param[in, out] Ascii Boolean value for indicating whether
>> the file is
>> + @param[in,out] Ascii Boolean value for indicating whether
>> the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @retval EFI_SUCCESS The operation was successful. The
>> line is stored in
>> diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> index a33cadd71646..af74ab732b21 100644
>> --- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> +++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> @@ -81,12 +81,12 @@ typedef struct {
>> is greater than zero, then this
>> function will return
>> EFI_TIMEOUT if the time
>> required to execute the SCSI
>> Request Packet is greater than
>> Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was
>> generated by
>> + @param[in,out] SenseData A pointer to sense data that was
>> generated by
>> the execution of the SCSI
>> Request Packet. This
>> buffer must be allocated by the
>> caller.
>> If SenseDataLength is 0, then
>> this parameter is
>> optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, a pointer to the length in
>> bytes of
>> + @param[in,out] SenseDataLength On input, a pointer to the length in
>> bytes of
>> the SenseData buffer. On
>> output, a pointer to
>> the number of bytes written to
>> the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that produces
>> @@ -199,12 +199,12 @@ ScsiTestUnitReadyCommand (
>> If Timeout is greater than
>> zero, then this function
>> will return EFI_TIMEOUT
>> if the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that
>> was generated
>> + @param[in,out] SenseData A pointer to sense data
>> that was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If SenseDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI
>> @@ -218,12 +218,12 @@ ScsiTestUnitReadyCommand (
>> See the EFI SCSI I/O
>> Protocol in the UEFI
>> Specification for details
>> on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If InquiryDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> of the InquiryDataBuffer
>> buffer.
>> On output, a pointer to
>> the number of bytes
>> written to the
>> InquiryDataBuffer buffer.
>> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
>> If Timeout is greater than
>> zero, then this function
>> will return EFI_TIMEOUT
>> if the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that
>> was generated
>> + @param[in,out] SenseData A pointer to sense data
>> that was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If SenseDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes
>> of the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI
>> @@ -366,12 +366,12 @@ ScsiInquiryCommandEx (
>> See the EFI SCSI I/O
>> Protocol in the UEFI
>> Specification for details
>> on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that
>> was generated
>> by the execution of the
>> SCSI Request Packet.
>> This buffer must be
>> allocated by the caller.
>> If InquiryDataLength is 0,
>> then this parameter
>> is optional and may be
>> NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the
>> length in bytes
>> of the InquiryDataBuffer
>> buffer.
>> On output, a pointer to
>> the number of bytes
>> written to the
>> InquiryDataBuffer buffer.
>> @@ -464,12 +464,12 @@ ScsiInquiryCommand (
>> If Timeout is greater than zero,
>> then this function
>> will return EFI_TIMEOUT if
>> the time required to
>> execute the SCSI Request
>> Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was
>> generated
>> + @param[in,out] SenseData A pointer to sense data that was
>> generated
>> by the execution of the SCSI
>> Request Packet.
>> This buffer must be allocated
>> by the caller.
>> If SenseDataLength is 0, then
>> this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of
>> the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of
>> the SenseData buffer.
>> On output, the number of
>> bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host
>> Controller that
>> produces the SCSI bus
>> containing the SCSI target
>> @@ -482,12 +482,12 @@ ScsiInquiryCommand (
>> on the SCSI Host Controller.
>> See the EFI SCSI
>> I/O Protocol in the UEFI
>> Specification for details
>> on the possible return values.
>> - @param[in, out] DataBuffer A pointer to data that was
>> generated by the
>> + @param[in,out] DataBuffer A pointer to data that was
>> generated by the
>> execution of the SCSI Request
>> Packet. This
>> buffer must be allocated by
>> the caller. If
>> DataLength is 0, then this
>> parameter is optional
>> and may be NULL.
>> - @param[in, out] DataLength On input, a pointer to the length
>> in bytes of
>> + @param[in,out] DataLength On input, a pointer to the length
>> in bytes of
>> the DataBuffer buffer. On
>> output, a pointer
>> to the number of bytes
>> written to the DataBuffer
>> buffer.
>> @@ -602,8 +602,8 @@ ScsiModeSense10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO
>> protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output sense
>> data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>>
>> @@ -687,12 +687,12 @@ ScsiRequestSenseCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @@ -790,12 +790,12 @@ ScsiReadCapacityCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @@ -896,12 +896,12 @@ ScsiReadCapacity16Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 10 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 10 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -995,12 +995,12 @@ ScsiRead10Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -1095,12 +1095,12 @@ ScsiWrite10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -1194,12 +1194,12 @@ ScsiRead16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks of data that shall be transferred.
>>
>> @@ -1293,8 +1293,8 @@ ScsiWrite16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output
>> sense data.
>> + @param[in,out] SenseData A pointer to output
>> sense data.
>> + @param[in,out] SenseDataLength The length of output
>> sense data.
>> @param[out] HostAdapterStatus The status of Host
>> Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to
>> use.
>> @@ -1302,7 +1302,7 @@ ScsiWrite16Command (
>> @param[in] Inc512 If TRUE, 512
>> increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL
>> IN command.
>> @param[in] DataLength The size in bytes of the
>> data buffer.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data
>> buffer.
>> @param[out] TransferLength A pointer to a buffer to
>> store the size in
>> bytes of the data
>> written to the data buffer.
>>
>> @@ -1408,8 +1408,8 @@ ScsiSecurityProtocolInCommand (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense
>> data.
>> - @param[in, out] SenseDataLength The length of output
>> sense data.
>> + @param[in,out] SenseData A pointer to output
>> sense data.
>> + @param[in,out] SenseDataLength The length of output
>> sense data.
>> @param[out] HostAdapterStatus The status of Host
>> Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to
>> use.
>> @@ -1417,7 +1417,7 @@ ScsiSecurityProtocolInCommand (
>> @param[in] Inc512 If TRUE, 512
>> increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL
>> OUT command.
>> @param[in] DataLength The size in bytes of the
>> transfer data.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data
>> buffer.
>>
>> @retval EFI_SUCCESS Command is executed
>> successfully.
>> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was
>> executed, but the entire DataBuffer could
>> @@ -1573,12 +1573,12 @@ ScsiLibNotify (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -1756,12 +1756,12 @@ ScsiRead10CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -1939,12 +1939,12 @@ ScsiWrite10CommandEx (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> @@ -2122,12 +2122,12 @@ ScsiRead16CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout
>> period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense
>> data.
>> + @param[in,out] SenseDataLength The length of output sense
>> data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous
>> logical blocks
>> of data that shall be
>> transferred.
>> --
>> 2.30.2
>>
>>
>>
>>
>>
>
>
>
>
>
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-02-20 18:45 [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out] Rebecca Cran
2023-02-21 1:58 ` [edk2-devel] " Tinh Nguyen
2023-03-10 3:03 ` 回复: " gaoliming
@ 2023-03-14 20:38 ` Michael D Kinney
2023-03-14 21:00 ` Rebecca Cran
2 siblings, 1 reply; 7+ messages in thread
From: Michael D Kinney @ 2023-03-14 20:38 UTC (permalink / raw)
To: devel@edk2.groups.io, quic_rcran@quicinc.com, Gao, Liming,
Liu, Zhiguang
Cc: Rebecca Cran, Kinney, Michael D
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>
Is there a tool we can run in CI to verify proper Doxygen syntax?
Mike
> -----Original Message-----
> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Rebecca Cran
> Sent: Monday, February 20, 2023 10:46 AM
> To: devel@edk2.groups.io; Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming <gaoliming@byosoft.com.cn>;
> Liu, Zhiguang <zhiguang.liu@intel.com>
> Cc: Rebecca Cran <rebecca@quicinc.com>
> Subject: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
>
> There isn't supposed to be whitespace for "@param [in,out]" between "in"
> and "out". clang generates the following warning:
>
> test.c:8:9: warning: whitespace is not allowed in parameter passing direction [-Wdocumentation-pedantic]
> @param [in, out] argv Array of arguments.
> ^~~~~~~~~
> [in,out]
>
> Update the documentation blocks in MdePkg.
>
> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
> ---
> MdePkg/Include/Library/BaseLib.h | 4 +-
> MdePkg/Include/Library/FileHandleLib.h | 12 +-
> MdePkg/Include/Library/PcdLib.h | 14 +--
> MdePkg/Include/Library/SmmPeriodicSmiLib.h | 2 +-
> MdePkg/Include/Library/UefiScsiLib.h | 124 ++++++++++----------
> MdePkg/Include/Ppi/CpuIo.h | 2 +-
> MdePkg/Include/Ppi/Graphics.h | 2 +-
> MdePkg/Include/Ppi/Pcd.h | 10 +-
> MdePkg/Include/Ppi/PiPcd.h | 2 +-
> MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h | 2 +-
> MdePkg/Include/Protocol/BlockIo2.h | 4 +-
> MdePkg/Include/Protocol/BlockIoCrypto.h | 6 +-
> MdePkg/Include/Protocol/BluetoothHc.h | 4 +-
> MdePkg/Include/Protocol/BluetoothIo.h | 4 +-
> MdePkg/Include/Protocol/BluetoothLeConfig.h | 10 +-
> MdePkg/Include/Protocol/CcMeasurement.h | 2 +-
> MdePkg/Include/Protocol/CpuIo2.h | 2 +-
> MdePkg/Include/Protocol/Eap.h | 2 +-
> MdePkg/Include/Protocol/EapConfiguration.h | 4 +-
> MdePkg/Include/Protocol/EapManagement.h | 2 +-
> MdePkg/Include/Protocol/EapManagement2.h | 8 +-
> MdePkg/Include/Protocol/EraseBlock.h | 2 +-
> MdePkg/Include/Protocol/FirmwareManagement.h | 6 +-
> MdePkg/Include/Protocol/I2cEnumerate.h | 2 +-
> MdePkg/Include/Protocol/IpSec.h | 16 +--
> MdePkg/Include/Protocol/IpSecConfig.h | 6 +-
> MdePkg/Include/Protocol/Kms.h | 72 ++++++------
> MdePkg/Include/Protocol/MmCommunication2.h | 6 +-
> MdePkg/Include/Protocol/MmSwDispatch.h | 2 +-
> MdePkg/Include/Protocol/Mtftp6.h | 2 +-
> MdePkg/Include/Protocol/Pcd.h | 8 +-
> MdePkg/Include/Protocol/PiPcd.h | 2 +-
> MdePkg/Include/Protocol/S3SaveState.h | 4 +-
> MdePkg/Include/Protocol/Shell.h | 8 +-
> MdePkg/Include/Protocol/SmartCardEdge.h | 12 +-
> MdePkg/Include/Protocol/SmartCardReader.h | 10 +-
> MdePkg/Include/Protocol/Smbios.h | 4 +-
> MdePkg/Include/Protocol/SmmSwDispatch2.h | 2 +-
> MdePkg/Include/Protocol/SuperIo.h | 2 +-
> MdePkg/Include/Protocol/Supplicant.h | 6 +-
> MdePkg/Include/Protocol/Tcg2Protocol.h | 2 +-
> MdePkg/Include/Protocol/Tls.h | 8 +-
> MdePkg/Include/Protocol/TlsConfig.h | 4 +-
> MdePkg/Include/Protocol/UfsDeviceConfig.h | 10 +-
> MdePkg/Include/Protocol/UsbFunctionIo.h | 12 +-
> MdePkg/Include/Protocol/UserCredential.h | 4 +-
> MdePkg/Include/Protocol/UserCredential2.h | 4 +-
> MdePkg/Include/Uefi/UefiSpec.h | 22 ++--
> MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c | 2 +-
> MdePkg/Library/BaseLib/QuickSort.c | 2 +-
> MdePkg/Library/BasePcdLibNull/PcdLib.c | 12 +-
> MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c | 8 +-
> MdePkg/Library/DxePcdLib/DxePcdLib.c | 12 +-
> MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c | 2 +-
> MdePkg/Library/PeiPcdLib/PeiPcdLib.c | 12 +-
> MdePkg/Library/SmmIoLib/SmmIoLib.c | 4 +-
> MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c | 8 +-
> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c | 12 +-
> MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 124 ++++++++++----------
> 59 files changed, 329 insertions(+), 329 deletions(-)
>
> diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/BaseLib.h
> index 8f2df76c29a3..0dee0f58aa75 100644
> --- a/MdePkg/Include/Library/BaseLib.h
> +++ b/MdePkg/Include/Library/BaseLib.h
> @@ -2482,7 +2482,7 @@ BcdToDecimal8 (
> /**
> Removes the last directory or file entry in a path.
>
> - @param[in, out] Path The pointer to the path to modify.
> + @param[in,out] Path The pointer to the path to modify.
>
> @retval FALSE Nothing was found to remove.
> @retval TRUE A directory or file was removed.
> @@ -2930,7 +2930,7 @@ INTN
>
> if Count is < 2 then perform no action.
>
> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
> on return a buffer of sorted elements
> @param[in] Count the number of elements in the buffer to sort
> @param[in] ElementSize Size of an element in bytes
> diff --git a/MdePkg/Include/Library/FileHandleLib.h b/MdePkg/Include/Library/FileHandleLib.h
> index 1a238edee38c..2ea97c317c27 100644
> --- a/MdePkg/Include/Library/FileHandleLib.h
> +++ b/MdePkg/Include/Library/FileHandleLib.h
> @@ -78,7 +78,7 @@ FileHandleSetInfo (
> EFI_FILE_INFO is the structure returned as the directory entry.
>
> @param[in] FileHandle The opened file handle.
> - @param[in, out] BufferSize On input, the size of buffer in bytes. On return,
> + @param[in,out] BufferSize On input, the size of buffer in bytes. On return,
> the number of bytes written.
> @param[out] Buffer The buffer to put read data into.
>
> @@ -109,7 +109,7 @@ FileHandleRead (
> opened directories are not supported.
>
> @param[in] FileHandle The opened file for writing.
> - @param[in, out] BufferSize On input, the number of bytes in Buffer. On output,
> + @param[in,out] BufferSize On input, the number of bytes in Buffer. On output,
> the number of bytes written.
> @param[in] Buffer The buffer containing data to write is stored.
>
> @@ -381,15 +381,15 @@ FileHandleGetFileName (
> read a CHAR_NULL character will be returned in buffer.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Buffer The pointer to buffer to read into.
> - @param[in, out] Size The pointer to number of bytes in Buffer.
> + @param[in,out] Buffer The pointer to buffer to read into.
> + @param[in,out] Size The pointer to number of bytes in Buffer.
> @param[in] Truncate If the buffer is large enough, this has no effect.
> If the buffer is is too small and Truncate is TRUE,
> the line will be truncated.
> If the buffer is is too small and Truncate is FALSE,
> then no read will occur.
>
> - @param[in, out] Ascii Boolean value for indicating whether the file is
> + @param[in,out] Ascii Boolean value for indicating whether the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @retval EFI_SUCCESS The operation was successful. The line is stored in
> @@ -418,7 +418,7 @@ FileHandleReadLine (
> maintained and not changed for all operations with the same file.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Ascii Boolean value for indicating whether the file is
> + @param[in,out] Ascii Boolean value for indicating whether the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @return The line of text from the file.
> diff --git a/MdePkg/Include/Library/PcdLib.h b/MdePkg/Include/Library/PcdLib.h
> index 4b103f0753c5..86739a3b2bd1 100644
> --- a/MdePkg/Include/Library/PcdLib.h
> +++ b/MdePkg/Include/Library/PcdLib.h
> @@ -1158,7 +1158,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -1303,7 +1303,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set a value from.
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -1354,7 +1354,7 @@ LibPcdSetExBoolS (
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being set.
> @param[in] TokenDataSize The size, in bytes, of the data being set.
>
> **/
> @@ -1474,7 +1474,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the Buffer that was set.
> @@ -1506,7 +1506,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> @@ -1540,7 +1540,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the Buffer that was set.
> @@ -1575,7 +1575,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Include/Library/SmmPeriodicSmiLib.h b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> index 83d9bdde0eb8..dd3745d65af8 100644
> --- a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> +++ b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
> @@ -104,7 +104,7 @@ VOID
> /**
> This function enables a periodic SMI handler.
>
> - @param[in, out] DispatchHandle A pointer to the handle associated with the
> + @param[in,out] DispatchHandle A pointer to the handle associated with the
> enabled periodic SMI handler. This is an
> optional parameter that may be NULL. If it is
> NULL, then the handle will not be returned,
> diff --git a/MdePkg/Include/Library/UefiScsiLib.h b/MdePkg/Include/Library/UefiScsiLib.h
> index da6ac2df68e7..90db37456ad2 100644
> --- a/MdePkg/Include/Library/UefiScsiLib.h
> +++ b/MdePkg/Include/Library/UefiScsiLib.h
> @@ -39,12 +39,12 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
> is greater than zero, then this function will return
> EFI_TIMEOUT if the time required to execute the SCSI
> Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated by
> + @param[in,out] SenseData A pointer to sense data that was generated by
> the execution of the SCSI Request Packet. This
> buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter is
> optional and may be NULL.
> - @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
> + @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
> the SenseData buffer. On output, a pointer to
> the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
> @@ -122,12 +122,12 @@ ScsiTestUnitReadyCommand (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI
> @@ -141,12 +141,12 @@ ScsiTestUnitReadyCommand (
> See the EFI SCSI I/O Protocol in the UEFI
> Specification for details on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If InquiryDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
> of the InquiryDataBuffer buffer.
> On output, a pointer to the number of bytes
> written to the InquiryDataBuffer buffer.
> @@ -223,12 +223,12 @@ ScsiInquiryCommand (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI
> @@ -242,12 +242,12 @@ ScsiInquiryCommand (
> See the EFI SCSI I/O Protocol in the UEFI
> Specification for details on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If InquiryDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
> of the InquiryDataBuffer buffer.
> On output, a pointer to the number of bytes
> written to the InquiryDataBuffer buffer.
> @@ -329,12 +329,12 @@ ScsiInquiryCommandEx (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI target
> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
> on the SCSI Host Controller. See the EFI SCSI
> I/O Protocol in the UEFI Specification for details
> on the possible return values.
> - @param[in, out] DataBuffer A pointer to data that was generated by the
> + @param[in,out] DataBuffer A pointer to data that was generated by the
> execution of the SCSI Request Packet. This
> buffer must be allocated by the caller. If
> DataLength is 0, then this parameter is optional
> and may be NULL.
> - @param[in, out] DataLength On input, a pointer to the length in bytes of
> + @param[in,out] DataLength On input, a pointer to the length in bytes of
> the DataBuffer buffer. On output, a pointer
> to the number of bytes written to the DataBuffer
> buffer.
> @@ -420,8 +420,8 @@ ScsiModeSense10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
>
> @@ -469,12 +469,12 @@ ScsiRequestSenseCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @@ -527,12 +527,12 @@ ScsiReadCapacityCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @@ -586,12 +586,12 @@ ScsiReadCapacity16Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 10 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 10 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -646,12 +646,12 @@ ScsiRead10Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -706,12 +706,12 @@ ScsiWrite10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -766,12 +766,12 @@ ScsiRead16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -825,8 +825,8 @@ ScsiWrite16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to use.
> @@ -834,7 +834,7 @@ ScsiWrite16Command (
> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
> SECURITY PROTOCOL IN command.
> @param[in] DataLength The size in bytes of the data buffer.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> @param[out] TransferLength A pointer to a buffer to store the size in
> bytes of the data written to the data buffer.
>
> @@ -889,8 +889,8 @@ ScsiSecurityProtocolInCommand (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to use.
> @@ -898,7 +898,7 @@ ScsiSecurityProtocolInCommand (
> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
> SECURITY PROTOCOL OUT command.
> @param[in] DataLength The size in bytes of the transfer data.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
> @@ -960,12 +960,12 @@ ScsiSecurityProtocolOutCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -1049,12 +1049,12 @@ ScsiRead10CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -1138,12 +1138,12 @@ ScsiWrite10CommandEx (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -1227,12 +1227,12 @@ ScsiRead16CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
> index 193a78e3c256..5e2ca4edbc22 100644
> --- a/MdePkg/Include/Ppi/CpuIo.h
> +++ b/MdePkg/Include/Ppi/CpuIo.h
> @@ -46,7 +46,7 @@ typedef enum {
> @param[in] Width The width of the access. Enumerated in bytes.
> @param[in] Address The physical address of the access.
> @param[in] Count The number of accesses to perform.
> - @param[in, out] Buffer A pointer to the buffer of data.
> + @param[in,out] Buffer A pointer to the buffer of data.
>
> @retval EFI_SUCCESS The function completed successfully.
> @retval EFI_NOT_YET_AVAILABLE The service has not been installed.
> diff --git a/MdePkg/Include/Ppi/Graphics.h b/MdePkg/Include/Ppi/Graphics.h
> index 3854f6c371c2..e8c1bc14b0ac 100644
> --- a/MdePkg/Include/Ppi/Graphics.h
> +++ b/MdePkg/Include/Ppi/Graphics.h
> @@ -48,7 +48,7 @@ EFI_STATUS
> The GraphicsPpiGetMode returns the mode information supported by the Graphics PEI
> Module.
>
> - @param[in, out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
> + @param[in,out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>
> @retval EFI_SUCCESS Valid mode information was returned.
> @retval EFI_INVALID_PARAMETER The Mode parameter is not valid.
> diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
> index d36a7f106cc8..3e6556314d1b 100644
> --- a/MdePkg/Include/Ppi/Pcd.h
> +++ b/MdePkg/Include/Ppi/Pcd.h
> @@ -420,7 +420,7 @@ EFI_STATUS
> If it is not, an error will be returned.
>
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
> + @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
> On input, if the SizeOfValue is greater than the maximum size supported
> for this TokenNumber then the output value of SizeOfValue will reflect
> the maximum size supported for this TokenNumber.
> @@ -578,7 +578,7 @@ EFI_STATUS
>
> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
> value.
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
> + @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
> On input, if the SizeOfValue is greater than the maximum size supported
> for this TokenNumber then the output value of SizeOfValue will reflect
> the maximum size supported for this TokenNumber.
> @@ -638,7 +638,7 @@ EFI_STATUS
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being set.
> @param[in] TokenDataSize The size, in bytes, of the data being set.
>
> @retval VOID
> @@ -712,7 +712,7 @@ EFI_STATUS
> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
> value.
> This is an optional parameter that may be NULL. If this parameter is NULL, then a
> request
> is being made to retrieve tokens from the default token space.
> - @param[in, out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
> + @param[in,out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
>
> @retval EFI_SUCCESS The PCD service has retrieved the next valid token number.
> @retval EFI_NOT_FOUND The PCD service could not find data from the requested token number.
> @@ -731,7 +731,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
> namespace from which the search will start. On output, it designates the next valid
> token namespace on the platform. If *Guid is NULL, then the GUID of the first token
> space of the current platform is returned. If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
> index 8d0f95eb27cc..8b137f2ca9e2 100644
> --- a/MdePkg/Include/Ppi/PiPcd.h
> +++ b/MdePkg/Include/Ppi/PiPcd.h
> @@ -387,7 +387,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
> namespace from which the search will start. On output, it designates the next valid
> token namespace on the platform. If *Guid is NULL, then the GUID of the first token
> space of the current platform is returned. If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> index 9e134200da54..f25c3a7cd641 100644
> --- a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> +++ b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
> @@ -162,7 +162,7 @@ EFI_STATUS
> Return the child ACPI objects.
>
> @param[in] ParentHandle Parent handle.
> - @param[in, out] Handle On entry, points to the previously returned handle or NULL to start with the
> first
> + @param[in,out] Handle On entry, points to the previously returned handle or NULL to start with the
> first
> handle. On return, points to the next returned ACPI handle or NULL if there are
> no
> child objects.
>
> diff --git a/MdePkg/Include/Protocol/BlockIo2.h b/MdePkg/Include/Protocol/BlockIo2.h
> index d25f51f73354..9bd5e7a6ddd9 100644
> --- a/MdePkg/Include/Protocol/BlockIo2.h
> +++ b/MdePkg/Include/Protocol/BlockIo2.h
> @@ -72,7 +72,7 @@ EFI_STATUS
> @param[in] MediaId Id of the media, changes every time the media is
> replaced.
> @param[in] Lba The starting Logical Block Address to read from.
> - @param[in, out] Token A pointer to the token associated with the transaction.
> + @param[in,out] Token A pointer to the token associated with the transaction.
> @param[in] BufferSize Size of Buffer, must be a multiple of device block size.
> @param[out] Buffer A pointer to the destination buffer for the data. The
> caller is responsible for either having implicit or
> @@ -116,7 +116,7 @@ EFI_STATUS
> @param[in] Lba The starting logical block address to be written. The
> caller is responsible for writing to only legitimate
> locations.
> - @param[in, out] Token A pointer to the token associated with the transaction.
> + @param[in,out] Token A pointer to the token associated with the transaction.
> @param[in] BufferSize Size of Buffer, must be a multiple of device block size.
> @param[in] Buffer A pointer to the source buffer for the data.
>
> diff --git a/MdePkg/Include/Protocol/BlockIoCrypto.h b/MdePkg/Include/Protocol/BlockIoCrypto.h
> index bcc0ed40beff..f15cde32f61b 100644
> --- a/MdePkg/Include/Protocol/BlockIoCrypto.h
> +++ b/MdePkg/Include/Protocol/BlockIoCrypto.h
> @@ -356,7 +356,7 @@ EFI_STATUS
> @param[in] MediaId The media ID that the read request is for.
> @param[in] LBA The starting logical block address to read from on
> the device.
> - @param[in, out] Token A pointer to the token associated with the transaction.
> + @param[in,out] Token A pointer to the token associated with the transaction.
> @param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
> of the intrinsic block size of the device.
> @param[out] Buffer A pointer to the destination buffer for the data. The
> @@ -423,7 +423,7 @@ EFI_STATUS
> @param[in] MediaId The media ID that the read request is for.
> @param[in] LBA The starting logical block address to read from on
> the device.
> - @param[in, out] Token A pointer to the token associated with the transaction.
> + @param[in,out] Token A pointer to the token associated with the transaction.
> @param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
> of the intrinsic block size of the device.
> @param[in] Buffer A pointer to the source buffer for the data.
> @@ -482,7 +482,7 @@ EFI_STATUS
> will not be signaled.
>
> @param[in] This Pointer to the EFI_BLOCK_IO_CRYPTO_PROTOCOL instance.
> - @param[in, out] Token A pointer to the token associated with the transaction.
> + @param[in,out] Token A pointer to the token associated with the transaction.
>
> @retval EFI_SUCCESS The flush request was queued if Event is not NULL. All
> outstanding data was written correctly to the device if
> diff --git a/MdePkg/Include/Protocol/BluetoothHc.h b/MdePkg/Include/Protocol/BluetoothHc.h
> index d75cb08f8928..29faf36fb7b7 100644
> --- a/MdePkg/Include/Protocol/BluetoothHc.h
> +++ b/MdePkg/Include/Protocol/BluetoothHc.h
> @@ -164,7 +164,7 @@ EFI_STATUS
> capability.
>
> @param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
> specified by Buffer. On output, indicates the amount of
> data actually transferred.
> @param[in] Buffer A pointer to the buffer of data that will be transmitted to
> @@ -200,7 +200,7 @@ EFI_STATUS
> ACL data packet, including Handle, PB flag, BC flag, data length, and data.
>
> @param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
> specified by Buffer. On output, indicates the amount of
> data actually transferred.
> @param[out] Buffer A pointer to the buffer of data that will be received from
> diff --git a/MdePkg/Include/Protocol/BluetoothIo.h b/MdePkg/Include/Protocol/BluetoothIo.h
> index 620bfbc961cc..b4f6aee73e55 100644
> --- a/MdePkg/Include/Protocol/BluetoothIo.h
> +++ b/MdePkg/Include/Protocol/BluetoothIo.h
> @@ -105,7 +105,7 @@ EFI_STATUS
> Send L2CAP message (including L2CAP header).
>
> @param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
> On output, indicates the amount of data actually transferred.
> @param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP
> layer.
> @param[in] Timeout Indicating the transfer should be completed within this time frame. The units are
> in
> @@ -212,7 +212,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
> @param[in] Handle A handle created by EFI_BLUETOOTH_IO_PROTOCOL.L2CapConnect indicates which
> channel to send.
> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
> On output, indicates the amount of data actually transferred.
> @param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP
> layer.
> @param[in] Timeout Indicating the transfer should be completed within this time frame. The units are
> in
> diff --git a/MdePkg/Include/Protocol/BluetoothLeConfig.h b/MdePkg/Include/Protocol/BluetoothLeConfig.h
> index 6331e60a8655..2ec8a48fc551 100644
> --- a/MdePkg/Include/Protocol/BluetoothLeConfig.h
> +++ b/MdePkg/Include/Protocol/BluetoothLeConfig.h
> @@ -234,9 +234,9 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
> On output, indicates the amount of data actually returned.
> - @param[in, out] Data A pointer to the buffer of data that will be returned.
> + @param[in,out] Data A pointer to the buffer of data that will be returned.
>
> @retval EFI_SUCCESS The BluetoothLE configuration data is returned successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
> @@ -293,9 +293,9 @@ EFI_STATUS
> @param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> @param[in] BDAddr Remote BluetoothLE device address.
> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
> On output, indicates the amount of data actually returned.
> - @param[in, out] Data A pointer to the buffer of data that will be returned.
> + @param[in,out] Data A pointer to the buffer of data that will be returned.
>
> @retval EFI_SUCCESS The remote BluetoothLE device configuration data is returned successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
> @@ -464,7 +464,7 @@ typedef enum {
> @param[in] BDAddr Remote BluetoothLE device address. For Local device setting, it
> should be NULL.
> @param[in] DataType Data type in EFI_BLUETOOTH_LE_SMP_DATA_TYPE.
> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified
> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified
> by Data. On output, indicates the amount of data actually returned.
> @param[out] Data A pointer to the buffer of data that will be returned.
>
> diff --git a/MdePkg/Include/Protocol/CcMeasurement.h b/MdePkg/Include/Protocol/CcMeasurement.h
> index 4bf21fc42fa0..555356d56d66 100644
> --- a/MdePkg/Include/Protocol/CcMeasurement.h
> +++ b/MdePkg/Include/Protocol/CcMeasurement.h
> @@ -139,7 +139,7 @@ typedef struct {
> capability information and state information.
>
> @param[in] This Indicates the calling context
> - @param[in, out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
> + @param[in,out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
> structure and sets the size field to the size of the structure allocated.
> The callee fills in the fields with the EFI CC BOOT Service capability
> information and the current CC information.
> diff --git a/MdePkg/Include/Protocol/CpuIo2.h b/MdePkg/Include/Protocol/CpuIo2.h
> index 39ddda62bfcf..baddbeb51de5 100644
> --- a/MdePkg/Include/Protocol/CpuIo2.h
> +++ b/MdePkg/Include/Protocol/CpuIo2.h
> @@ -81,7 +81,7 @@ typedef enum {
> @param[in] Address The base address of the I/O operation.
> @param[in] Count The number of I/O operations to perform. The number
> of bytes moved is Width size * Count, starting at Address.
> - @param[in, out] Buffer For read operations, the destination buffer to store the results.
> + @param[in,out] Buffer For read operations, the destination buffer to store the results.
> For write operations, the source buffer from which to write data.
>
> @retval EFI_SUCCESS The data was read from or written to the PI system.
> diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h
> index 37b94b55c998..2c69772225ad 100644
> --- a/MdePkg/Include/Protocol/Eap.h
> +++ b/MdePkg/Include/Protocol/Eap.h
> @@ -54,7 +54,7 @@ typedef VOID *EFI_PORT_HANDLE;
> @param[in] RequestSize Packet size in bytes for the most recently received
> EAP-Request packet.
> @param[in] Buffer Pointer to the buffer to hold the built packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes.
> + @param[in,out] BufferSize Pointer to the buffer size in bytes.
> On input, it is the buffer size provided by the caller.
> On output, it is the buffer size in fact needed to contain
> the packet.
> diff --git a/MdePkg/Include/Protocol/EapConfiguration.h b/MdePkg/Include/Protocol/EapConfiguration.h
> index 6fcddabcb7b2..4bd100677b55 100644
> --- a/MdePkg/Include/Protocol/EapConfiguration.h
> +++ b/MdePkg/Include/Protocol/EapConfiguration.h
> @@ -114,8 +114,8 @@ EFI_STATUS
> @param[in] This Pointer to the EFI_EAP_CONFIGURATION_PROTOCOL instance.
> @param[in] EapType EAP type.
> @param[in] DataType Configuration data type.
> - @param[in, out] Data Pointer to configuration data.
> - @param[in, out] DataSize Total size of configuration data. On input, it means
> + @param[in,out] Data Pointer to configuration data.
> + @param[in,out] DataSize Total size of configuration data. On input, it means
> the size of Data buffer. On output, it means the size
> of copied Data buffer if EFI_SUCCESS, and means the
> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
> diff --git a/MdePkg/Include/Protocol/EapManagement.h b/MdePkg/Include/Protocol/EapManagement.h
> index ea1b0d71e357..20f915e30cf5 100644
> --- a/MdePkg/Include/Protocol/EapManagement.h
> +++ b/MdePkg/Include/Protocol/EapManagement.h
> @@ -294,7 +294,7 @@ EFI_STATUS
> instance that indicates the calling context.
> @param[out] CurrentState Returns the current state of the Supplicant PAE
> state machine for the Port.
> - @param[in, out] Configuration Returns the configuration of the operational
> + @param[in,out] Configuration Returns the configuration of the operational
> parameters of the Supplicant PAE state machine
> for the Port as required. This parameter can be
> NULL to ignore reading the configuration.
> diff --git a/MdePkg/Include/Protocol/EapManagement2.h b/MdePkg/Include/Protocol/EapManagement2.h
> index ab42b04e1a04..768f82b6aab2 100644
> --- a/MdePkg/Include/Protocol/EapManagement2.h
> +++ b/MdePkg/Include/Protocol/EapManagement2.h
> @@ -33,10 +33,10 @@ typedef struct _EFI_EAP_MANAGEMENT2_PROTOCOL EFI_EAP_MANAGEMENT2_PROTOCOL;
> MAC layer driver can use MSK to derive more keys, e.g. PMK (Pairwise Master Key).
>
> @param[in] This Pointer to the EFI_EAP_MANAGEMENT2_PROTOCOL instance.
> - @param[in, out] Msk Pointer to MSK (Master Session Key) buffer.
> - @param[in, out] MskSize MSK buffer size.
> - @param[in, out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
> - @param[in, out] EmskSize EMSK buffer size.
> + @param[in,out] Msk Pointer to MSK (Master Session Key) buffer.
> + @param[in,out] MskSize MSK buffer size.
> + @param[in,out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
> + @param[in,out] EmskSize EMSK buffer size.
>
> @retval EFI_SUCCESS The operation completed successfully.
> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
> diff --git a/MdePkg/Include/Protocol/EraseBlock.h b/MdePkg/Include/Protocol/EraseBlock.h
> index bfa5921400aa..5f71ccdf9a0e 100644
> --- a/MdePkg/Include/Protocol/EraseBlock.h
> +++ b/MdePkg/Include/Protocol/EraseBlock.h
> @@ -45,7 +45,7 @@ typedef struct {
> @param[in] LBA The starting logical block address to be
> erased. The caller is responsible for erasing
> only legitimate locations.
> - @param[in, out] Token A pointer to the token associated with the
> + @param[in,out] Token A pointer to the token associated with the
> transaction.
> @param[in] Size The size in bytes to be erased. This must be
> a multiple of the physical block size of the
> diff --git a/MdePkg/Include/Protocol/FirmwareManagement.h b/MdePkg/Include/Protocol/FirmwareManagement.h
> index f37067df3455..3bdebc29accd 100644
> --- a/MdePkg/Include/Protocol/FirmwareManagement.h
> +++ b/MdePkg/Include/Protocol/FirmwareManagement.h
> @@ -286,12 +286,12 @@ EFI_STATUS
> The saved copy could later been used, for example, in firmware image recovery or rollback.
>
> @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance.
> - @param[in, out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
> + @param[in,out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
> On input, this is the size of the buffer allocated by the caller.
> On output, it is the size of the buffer returned by the firmware
> if the buffer was large enough, or the size of the buffer needed
> to contain the image(s) information if the buffer was too small.
> - @param[in, out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
> + @param[in,out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
> information. The information is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs.
> @param[out] DescriptorVersion A pointer to the location in which firmware returns the version number
> associated with the EFI_FIRMWARE_IMAGE_DESCRIPTOR.
> @@ -340,7 +340,7 @@ EFI_STATUS
> @param[in] ImageIndex A unique number identifying the firmware image(s) within the device.
> The number is between 1 and DescriptorCount.
> @param[out] Image Points to the buffer where the current image is copied to.
> - @param[in, out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
> + @param[in,out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
> On return, points to the length of the image, in bytes.
>
> @retval EFI_SUCCESS The device was successfully updated with the new image.
> diff --git a/MdePkg/Include/Protocol/I2cEnumerate.h b/MdePkg/Include/Protocol/I2cEnumerate.h
> index e1890e470c62..be07979043ae 100644
> --- a/MdePkg/Include/Protocol/I2cEnumerate.h
> +++ b/MdePkg/Include/Protocol/I2cEnumerate.h
> @@ -28,7 +28,7 @@ typedef struct _EFI_I2C_ENUMERATE_PROTOCOL EFI_I2C_ENUMERATE_PROTOCOL;
>
> @param[in] This The platform data for the next device on
> the I2C bus was returned successfully.
> - @param[in, out] Device Pointer to a buffer containing an
> + @param[in,out] Device Pointer to a buffer containing an
> EFI_I2C_DEVICE structure. Enumeration is
> started by setting the initial EFI_I2C_DEVICE
> structure pointer to NULL. The buffer
> diff --git a/MdePkg/Include/Protocol/IpSec.h b/MdePkg/Include/Protocol/IpSec.h
> index 0b5d55a85293..6295bf43d401 100644
> --- a/MdePkg/Include/Protocol/IpSec.h
> +++ b/MdePkg/Include/Protocol/IpSec.h
> @@ -55,11 +55,11 @@ typedef struct _EFI_IPSEC_FRAGMENT_DATA {
> @param[in] This Pointer to the EFI_IPSEC_PROTOCOL instance.
> @param[in] NicHandle Instance of the network interface.
> @param[in] IpVer IPV4 or IPV6.
> - @param[in, out] IpHead Pointer to the IP Header.
> + @param[in,out] IpHead Pointer to the IP Header.
> @param[in] LastHead The protocol of the next layer to be processed by IPsec.
> @param[in] OptionsBuffer Pointer to the options buffer.
> @param[in] OptionsLength Length of the options buffer.
> - @param[in, out] FragmentTable Pointer to a list of fragments.
> + @param[in,out] FragmentTable Pointer to a list of fragments.
> @param[in] FragmentCount Number of fragments.
> @param[in] TrafficDirection Traffic direction.
> @param[out] RecycleSignal Event for recycling of resources.
> @@ -111,7 +111,7 @@ struct _EFI_IPSEC_PROTOCOL {
> @param[in] This Pointer to the EFI_IPSEC2_PROTOCOL instance.
> @param[in] NicHandle Instance of the network interface.
> @param[in] IpVer IP version.IPv4 or IPv6.
> - @param[in, out] IpHead Pointer to the IP Header it is either
> + @param[in,out] IpHead Pointer to the IP Header it is either
> the EFI_IP4_HEADER or EFI_IP6_HEADER.
> On input, it contains the IP header.
> On output, 1) in tunnel mode and the
> @@ -123,10 +123,10 @@ struct _EFI_IPSEC_PROTOCOL {
> mode, the related fielders (like payload
> length, Next header) in IP header will
> be modified according to the condition.
> - @param[in, out] LastHead For IP4, it is the next protocol in IP
> + @param[in,out] LastHead For IP4, it is the next protocol in IP
> header. For IP6 it is the Next Header
> of the last extension header.
> - @param[in, out] OptionsBuffer On input, it contains the options
> + @param[in,out] OptionsBuffer On input, it contains the options
> (extensions header) to be processed by
> IPsec. On output, 1) in tunnel mode and
> the traffic direction is outbound, it
> @@ -143,10 +143,10 @@ struct _EFI_IPSEC_PROTOCOL {
> might be same with input's. The caller
> should take the responsibility to free
> the buffer both on input and on output.
> - @param[in, out] OptionsLength On input, the input length of the options
> + @param[in,out] OptionsLength On input, the input length of the options
> buffer. On output, the output length of
> the options buffer.
> - @param[in, out] FragmentTable Pointer to a list of fragments. On input,
> + @param[in,out] FragmentTable Pointer to a list of fragments. On input,
> these fragments contain the IP payload.
> On output, 1) in tunnel mode and the traffic
> direction is inbound, the fragments contain
> @@ -167,7 +167,7 @@ struct _EFI_IPSEC_PROTOCOL {
> payload which encapsulates the next layer
> protocol information between the encapsulated
> header and encapsulated trailer fields.
> - @param[in, out] FragmentCount Number of fragments.
> + @param[in,out] FragmentCount Number of fragments.
> @param[in] TrafficDirection Traffic direction.
> @param[out] RecycleSignal Event for recycling of resources.
>
> diff --git a/MdePkg/Include/Protocol/IpSecConfig.h b/MdePkg/Include/Protocol/IpSecConfig.h
> index 7136060691ca..2c9d3d8ddd45 100644
> --- a/MdePkg/Include/Protocol/IpSecConfig.h
> +++ b/MdePkg/Include/Protocol/IpSecConfig.h
> @@ -647,7 +647,7 @@ EFI_STATUS
> @param[in] DataType The type of data to retrieve.
> @param[in] Selector Pointer to an entry selector which is an identifier of the IPsec
> configuration data entry.
> - @param[in, out] DataSize On output the size of data returned in Data.
> + @param[in,out] DataSize On output the size of data returned in Data.
> @param[out] Data The buffer to return the contents of the IPsec configuration data.
> The type of the data buffer is associated with the DataType.
>
> @@ -692,8 +692,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_IPSEC_CONFIG_PROTOCOL instance.
> @param[in] DataType The type of IPsec configuration data to retrieve.
> - @param[in, out] SelectorSize The size of the Selector buffer.
> - @param[in, out] Selector On input, supplies the pointer to last Selector that was
> + @param[in,out] SelectorSize The size of the Selector buffer.
> + @param[in,out] Selector On input, supplies the pointer to last Selector that was
> returned by GetNextSelector().
> On output, returns one copy of the current entry Selector
> of a given DataType.
> diff --git a/MdePkg/Include/Protocol/Kms.h b/MdePkg/Include/Protocol/Kms.h
> index c37fcbb65c63..b63e7d2cbd1b 100644
> --- a/MdePkg/Include/Protocol/Kms.h
> +++ b/MdePkg/Include/Protocol/Kms.h
> @@ -366,7 +366,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -379,7 +379,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -419,11 +419,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> processed by this operation. On return, this number
> will be updated with the number of key descriptors
> successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> structures which describe the keys to be generated.
> On input, the KeyIdentifierSize and the KeyIdentifier
> may specify an identifier to be used for the key,
> @@ -447,7 +447,7 @@ EFI_STATUS
> type and must be freed by the caller when it is no longer
> needed. Also, the KeyStatus field must reflect the result
> of the request relative to that key.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -460,7 +460,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -514,11 +514,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> processed by this operation. On return, this number
> will be updated with the number of key descriptors
> successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> structures which describe the keys to be retrieved
> from the KMS.
> On input, the KeyIdentifierSize and the KeyIdentifier
> @@ -533,7 +533,7 @@ EFI_STATUS
> must be freed by the caller when it is no longer needed.
> Also, the KeyStatus field will reflect the result of the
> request relative to the individual key descriptor.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -546,7 +546,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -602,11 +602,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> processed by this operation. On normal return, this
> number will be updated with the number of key
> descriptors successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> structures which describe the keys to be added.
> On input, the KeyId field for first key must contain
> valid identifier data to be used for adding a key to
> @@ -619,7 +619,7 @@ EFI_STATUS
> consistent values to be associated with the given KeyId.
> On return, the KeyStatus field will reflect the result
> of the operation for each key request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -632,7 +632,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -688,11 +688,11 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
> processed by this operation. On normal return, this
> number will be updated with the number of key
> descriptors successfully processed.
> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> structures which describe the keys to be deleted.
> On input, the KeyId field for first key must contain
> valid identifier data to be used for adding a key to
> @@ -704,7 +704,7 @@ EFI_STATUS
> KeyValue fields are ignored, but should be 0.
> On return, the KeyStatus field will reflect the result
> of the operation for each key request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -717,7 +717,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -770,19 +770,19 @@ EFI_STATUS
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> structures associated with the Key identifier. If none
> are found, the count value is zero on return.
> On input this value reflects the number of KeyAttributes
> that may be returned.
> On output, the value reflects the number of completed
> KeyAttributes structures found.
> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> structures associated with the Key Identifier.
> On input, the fields in the structure should be NULL.
> On output, the attribute fields will have updated values
> for attributes associated with this key identifier.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -795,7 +795,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -858,18 +858,18 @@ EFI_STATUS
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> structures to associate with the Key. On normal returns,
> this number will be updated with the number of key
> attributes successfully processed.
> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> structures providing the attribute information to
> associate with the key.
> On input, the values for the fields in the structure
> are completely filled in.
> On return the KeyAttributeStatus field will reflect the
> result of the operation for each key attribute request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -882,7 +882,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -948,19 +948,19 @@ EFI_STATUS
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
> structures to associate with the Key.
> On input, the count value is one or more.
> On normal returns, this number will be updated with
> the number of key attributes successfully processed.
> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> structures providing the attribute information to
> associate with the key.
> On input, the values for the fields in the structure
> are completely filled in.
> On return the KeyAttributeStatus field will reflect the
> result of the operation for each key attribute request.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -973,7 +973,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> @@ -1029,23 +1029,23 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
> - @param[in, out] KeyAttributesCount Pointer to a count of the number of key attribute structures
> + @param[in,out] KeyAttributesCount Pointer to a count of the number of key attribute structures
> that must be matched for each returned key descriptor.
> On input the count value is one or more.
> On normal returns, this number will be updated with
> the number of key attributes successfully processed.
> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
> structure to search for.
> On input, the values for the fields in the structure are
> completely filled in.
> On return the KeyAttributeStatus field will reflect the
> result of the operation for each key attribute request.
> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
> by this operation.
> On entry, this number will be zero.
> On return, this number will be updated to the number
> of key descriptors successfully found.
> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
> structures which describe the keys from the KMS
> having the KeyAttribute(s) specified.
> On input, this pointer will be NULL.
> @@ -1057,7 +1057,7 @@ EFI_STATUS
> caller when it is no longer needed. Also, the KeyStatus
> field of each descriptor will reflect the result of the
> request relative to that key descriptor.
> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
> data specified by the ClientData parameter. This
> parameter may be NULL, in which case the ClientData
> parameter will be ignored and no data will be
> @@ -1070,7 +1070,7 @@ EFI_STATUS
> In all cases, the value upon return to the caller will
> be the size of the data block returned to the caller,
> which will be zero if no data is returned from the KMS.
> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
> *ClientDataSize that is to be passed directly to the
> KMS if it supports the use of client data. This
> parameter may be NULL if and only if the
> diff --git a/MdePkg/Include/Protocol/MmCommunication2.h b/MdePkg/Include/Protocol/MmCommunication2.h
> index 1b56320c7fff..86f74d9d2fa8 100644
> --- a/MdePkg/Include/Protocol/MmCommunication2.h
> +++ b/MdePkg/Include/Protocol/MmCommunication2.h
> @@ -28,9 +28,9 @@ typedef struct _EFI_MM_COMMUNICATION2_PROTOCOL EFI_MM_COMMUNICATION2_PROTOCOL;
> This function provides a service to send and receive messages from a registered UEFI service.
>
> @param[in] This The EFI_MM_COMMUNICATION_PROTOCOL instance.
> - @param[in, out] CommBufferPhysical Physical address of the MM communication buffer
> - @param[in, out] CommBufferVirtual Virtual address of the MM communication buffer
> - @param[in, out] CommSize The size of the data buffer being passed in. On exit, the
> + @param[in,out] CommBufferPhysical Physical address of the MM communication buffer
> + @param[in,out] CommBufferVirtual Virtual address of the MM communication buffer
> + @param[in,out] CommSize The size of the data buffer being passed in. On exit, the
> size of data being returned. Zero if the handler does not
> wish to reply with any data. This parameter is optional
> and may be NULL.
> diff --git a/MdePkg/Include/Protocol/MmSwDispatch.h b/MdePkg/Include/Protocol/MmSwDispatch.h
> index e7810662ecdb..fdecac020e5e 100644
> --- a/MdePkg/Include/Protocol/MmSwDispatch.h
> +++ b/MdePkg/Include/Protocol/MmSwDispatch.h
> @@ -62,7 +62,7 @@ typedef struct _EFI_MM_SW_DISPATCH_PROTOCOL EFI_MM_SW_DISPATCH_PROTOCOL;
> @param[in] This Pointer to the EFI_MM_SW_DISPATCH_PROTOCOL instance.
> @param[in] DispatchFunction Function to register for handler when the specified software
> MMI is generated.
> - @param[in, out] RegisterContext Pointer to the dispatch function's context.
> + @param[in,out] RegisterContext Pointer to the dispatch function's context.
> The caller fills this context in before calling
> the register function to indicate to the register
> function which Software MMI input value the
> diff --git a/MdePkg/Include/Protocol/Mtftp6.h b/MdePkg/Include/Protocol/Mtftp6.h
> index 4abf296c1c01..ce5a1409c943 100644
> --- a/MdePkg/Include/Protocol/Mtftp6.h
> +++ b/MdePkg/Include/Protocol/Mtftp6.h
> @@ -368,7 +368,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.
> @param[in] Token The token provided in the EFI_MTFTP6_PROTOCOL.WriteFile() by the caller.
> - @param[in, out] Length Indicates the length of the raw data wanted on input, and the
> + @param[in,out] Length Indicates the length of the raw data wanted on input, and the
> length the data available on output.
> @param[out] Buffer Pointer to the buffer where the data is stored.
>
> diff --git a/MdePkg/Include/Protocol/Pcd.h b/MdePkg/Include/Protocol/Pcd.h
> index 25f73cda1423..56c7f03e2c99 100644
> --- a/MdePkg/Include/Protocol/Pcd.h
> +++ b/MdePkg/Include/Protocol/Pcd.h
> @@ -424,7 +424,7 @@ EFI_STATUS
> If it is not, an error will be returned.
>
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
> + @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
> On input, if the SizeOfValue is greater than the maximum size supported
> for this TokenNumber then the output value of SizeOfValue will reflect
> the maximum size supported for this TokenNumber.
> @@ -582,7 +582,7 @@ EFI_STATUS
>
> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
> value.
> @param[in] TokenNumber The PCD token number.
> - @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
> + @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
> On input, if the SizeOfValue is greater than the maximum size supported
> for this TokenNumber then the output value of SizeOfValue will reflect
> the maximum size supported for this TokenNumber.
> @@ -643,7 +643,7 @@ EFI_STATUS
>
> @param[in] CallBackGuid The PCD token GUID being set.
> @param[in] CallBackToken The PCD token number being set.
> - @param[in, out] TokenData A pointer to the token data being set.
> + @param[in,out] TokenData A pointer to the token data being set.
> @param[in] TokenDataSize The size, in bytes, of the data being set.
>
> @retval VOID
> @@ -737,7 +737,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
> from which the search will start. On output, it designates the next valid token
> namespace on the platform. If *Guid is NULL, then the GUID of the first token
> space of the current platform is returned. If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/PiPcd.h b/MdePkg/Include/Protocol/PiPcd.h
> index e26733b5d9db..63b198c63e0e 100644
> --- a/MdePkg/Include/Protocol/PiPcd.h
> +++ b/MdePkg/Include/Protocol/PiPcd.h
> @@ -379,7 +379,7 @@ EFI_STATUS
> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
> token namespaces on a platform.
>
> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
> from which the search will start. On output, it designates the next valid token
> namespace on the platform. If *Guid is NULL, then the GUID of the first token
> space of the current platform is returned. If the search cannot locate the next valid
> diff --git a/MdePkg/Include/Protocol/S3SaveState.h b/MdePkg/Include/Protocol/S3SaveState.h
> index c2b26944fb41..f9f45e0a115a 100644
> --- a/MdePkg/Include/Protocol/S3SaveState.h
> +++ b/MdePkg/Include/Protocol/S3SaveState.h
> @@ -72,7 +72,7 @@ EFI_STATUS
> in the boot script table specified by Position. If Position is NULL or points
> to
> NULL then the new opcode is inserted at the beginning of the table (if TRUE) or
> end
> of the table (if FALSE).
> - @param[in, out] Position On entry, specifies the position in the boot script table where the opcode will
> be
> + @param[in,out] Position On entry, specifies the position in the boot script table where the opcode will
> be
> inserted, either before or after, depending on BeforeOrAfter. On exit,
> specifies
> the position of the inserted opcode in the boot script table.
> @param[in] OpCode The operation code (opcode) number. See "Related Definitions" in Write() for
> the
> @@ -111,7 +111,7 @@ EFI_STATUS
> NULL then the new label is inserted at the beginning of the table (if TRUE)
> or end of
> the table (if FALSE).
> @param[in] CreateIfNotFound Specifies whether the label will be created if the label does not exists
> (TRUE) or not (FALSE).
> - @param[in, out] Position On entry, specifies the position in the boot script table where the label
> will be inserted,
> + @param[in,out] Position On entry, specifies the position in the boot script table where the label
> will be inserted,
> either before or after, depending on BeforeOrAfter. On exit, specifies the
> position
> of the inserted label in the boot script table.
> @param[in] Label Points to the label which will be inserted in the boot script table.
> diff --git a/MdePkg/Include/Protocol/Shell.h b/MdePkg/Include/Protocol/Shell.h
> index 5efee49e197a..413dd0e4acbb 100644
> --- a/MdePkg/Include/Protocol/Shell.h
> +++ b/MdePkg/Include/Protocol/Shell.h
> @@ -734,7 +734,7 @@ EFI_STATUS
> If there are multiple map names they will be semi-colon seperated in the
> NULL-terminated string.
>
> - @param[in, out] DevicePath On entry, points to a device path pointer. On
> + @param[in,out] DevicePath On entry, points to a device path pointer. On
> exit, updates the pointer to point to the
> portion of the device path after the mapping.
>
> @@ -846,7 +846,7 @@ EFI_STATUS
> @param[in] Path A pointer to the path string.
> @param[in] OpenMode Specifies the mode used to open each file, EFI_FILE_MODE_READ or
> EFI_FILE_MODE_WRITE.
> - @param[in, out] FileList Points to the start of a list of files opened.
> + @param[in,out] FileList Points to the start of a list of files opened.
>
> @retval EFI_SUCCESS Create the file list successfully.
> @return Can't create the file list.
> @@ -915,7 +915,7 @@ EFI_STATUS
>
> @param[in] FileHandle The opened file handle for read.
> @param[in] ReadSize On input, the size of Buffer, in bytes. On output, the amount of data read.
> - @param[in, out] Buffer The buffer in which data is read.
> + @param[in,out] Buffer The buffer in which data is read.
>
> @retval EFI_SUCCESS Data was read.
> @retval EFI_NO_MEDIA The device has no media.
> @@ -1157,7 +1157,7 @@ EFI_STATUS
> Direct writes to opened directories are not supported.
>
> @param[in] FileHandle The opened file handle for writing.
> - @param[in, out] BufferSize On input, size of Buffer.
> + @param[in,out] BufferSize On input, size of Buffer.
> @param[in] Buffer The buffer in which data to write.
>
> @retval EFI_SUCCESS Data was written.
> diff --git a/MdePkg/Include/Protocol/SmartCardEdge.h b/MdePkg/Include/Protocol/SmartCardEdge.h
> index 1251680ec02f..2cf639a32633 100644
> --- a/MdePkg/Include/Protocol/SmartCardEdge.h
> +++ b/MdePkg/Include/Protocol/SmartCardEdge.h
> @@ -225,13 +225,13 @@ extern EFI_GUID gEfiPaddingRsaesOaepGuid;
>
> @param[in] This Indicates a pointer to the calling context.
> @param[out] NumberAidSupported Number of AIDs this protocol supports.
> - @param[in, out] AidTableSize On input, number of items allocated for the
> + @param[in,out] AidTableSize On input, number of items allocated for the
> AID table. On output, number of items returned
> by protocol.
> @param[out] AidTable Table of the AIDs supported by the protocol.
> @param[out] NumberSCPresent Number of currently present Smart Cards that
> are supported by protocol.
> - @param[in, out] CsnTableSize On input, the number of items the buffer CSN
> + @param[in,out] CsnTableSize On input, the number of items the buffer CSN
> table can contain. On output, the number of
> items returned by the protocol.
> @param[out] CsnTable Table of the CSN of the Smart Card present and
> @@ -343,7 +343,7 @@ EFI_STATUS
>
> @param[in] This Indicates a pointer to the calling context.
> @param[in] SCardHandle Handle on Smart Card connection.
> - @param[in, out] ReaderNameLength On input, a pointer to the variable that holds
> + @param[in,out] ReaderNameLength On input, a pointer to the variable that holds
> the maximal size, in bytes, of ReaderName.
> On output, the required size, in bytes, for ReaderName.
> @param[out] ReaderName A pointer to a NULL terminated string that will
> @@ -455,7 +455,7 @@ EFI_STATUS
> @param[in] This Indicates a pointer to the calling context.
> @param[in] SCardHandle Handle on Smart Card connection.
> @param[in] DataId The type identifier of the data to get.
> - @param[in, out] DataSize On input, in bytes, the size of Data. On output,
> + @param[in,out] DataSize On input, in bytes, the size of Data. On output,
> in bytes, the size of buffer required to store
> the specified data.
> @param[out] Data The data buffer in which the data is returned.
> @@ -507,7 +507,7 @@ EFI_STATUS
>
> @param[in] This Indicates a pointer to the calling context.
> @param[in] SCardHandle Handle on Smart Card connection.
> - @param[in, out] CredentialSize On input, in bytes, the size of buffer to store
> + @param[in,out] CredentialSize On input, in bytes, the size of buffer to store
> the list of credential.
> On output, in bytes, the size of buffer required
> to store the entire list of credentials.
> @@ -623,7 +623,7 @@ EFI_STATUS
> - EFI_PADDING_RSAES_OAEP_GUID
> @param[in] EncryptedSize Size of data to decrypt.
> @param[in] EncryptedData Data to decrypt
> - @param[in, out] PlaintextSize On input, in bytes, the size of buffer to store
> + @param[in,out] PlaintextSize On input, in bytes, the size of buffer to store
> the decrypted data.
> On output, in bytes, the size of buffer required
> to store the decrypted data.
> diff --git a/MdePkg/Include/Protocol/SmartCardReader.h b/MdePkg/Include/Protocol/SmartCardReader.h
> index 0ce117c9c764..a65b40932ec5 100644
> --- a/MdePkg/Include/Protocol/SmartCardReader.h
> +++ b/MdePkg/Include/Protocol/SmartCardReader.h
> @@ -135,13 +135,13 @@ EFI_STATUS
> @param[in] This Indicates a pointer to the calling context.
> @param[out] ReaderName A pointer to a NULL terminated string that will
> contain the reader name.
> - @param[in, out] ReaderNameLength On input, a pointer to the variablethat holds the
> + @param[in,out] ReaderNameLength On input, a pointer to the variablethat holds the
> maximal size, in bytes,of ReaderName.
> On output, the required size, in bytes, for ReaderName.
> @param[out] State Current state of the smart card reader.
> @param[out] CardProtocol Current protocol used to communicate with the smart card.
> @param[out] Atr A pointer to retrieve the ATR of the smart card.
> - @param[in, out] AtrLength On input, a pointer to hold the maximum size, in bytes,
> + @param[in,out] AtrLength On input, a pointer to hold the maximum size, in bytes,
> of Atr(usually 33).
> On output, the required size, inbytes, for the smart
> card ATR.
> @@ -184,7 +184,7 @@ EFI_STATUS
> @param[in] CAPDULength Command APDU size, in bytes.
> @param[out] RAPDU A pointer to a byte array that will contain the
> Response APDU.
> - @param[in, out] RAPDULength On input, the maximum size, inbytes, of the Response
> + @param[in,out] RAPDULength On input, the maximum size, inbytes, of the Response
> APDU.
> On output, the size, in bytes, of the Response APDU.
>
> @@ -226,7 +226,7 @@ EFI_STATUS
> @param[in] InBuffer A pointer to the input parameters.
> @param[in] InBufferLength Size, in bytes, of input parameters.
> @param[out] OutBuffer A pointer to the output parameters.
> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to store output
> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to store output
> parameters.
> On output, the size, in bytes, of output parameters.
>
> @@ -271,7 +271,7 @@ EFI_STATUS
> @param[in] Attrib Identifier for the attribute to retrieve.
> @param[out] OutBuffer A pointer to a buffer that will contain
> attribute data.
> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to store
> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to store
> attribute data.
> On output, the size, in bytes, of attribute
> data.
> diff --git a/MdePkg/Include/Protocol/Smbios.h b/MdePkg/Include/Protocol/Smbios.h
> index f9346aac7224..83e8065f6fa3 100644
> --- a/MdePkg/Include/Protocol/Smbios.h
> +++ b/MdePkg/Include/Protocol/Smbios.h
> @@ -97,7 +97,7 @@ typedef struct _EFI_SMBIOS_PROTOCOL EFI_SMBIOS_PROTOCOL;
>
> @param[in] This The EFI_SMBIOS_PROTOCOL instance.
> @param[in] ProducerHandle The handle of the controller or driver associated with the SMBIOS
> information. NULL means no handle.
> - @param[in, out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique
> handle
> + @param[in,out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique
> handle
> will be assigned to the SMBIOS record. If the SMBIOS handle is already in
> use,
> EFI_ALREADY_STARTED is returned and the SMBIOS record is not updated.
> @param[in] Record The data for the fixed portion of the SMBIOS record. The format of the
> record is
> @@ -168,7 +168,7 @@ EFI_STATUS
> only the SMBIOS records that match the optional Type argument.
>
> @param[in] This The EFI_SMBIOS_PROTOCOL instance.
> - @param[in, out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points
> to the
> + @param[in,out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points
> to the
> next SMBIOS record handle. If it is FFFEh on entry, then the first SMBIOS
> record
> handle will be returned. If it returns FFFEh on exit, then there are no more
> SMBIOS records.
> @param[in] Type On entry, it points to the type of the next SMBIOS record to return. If NULL,
> it
> diff --git a/MdePkg/Include/Protocol/SmmSwDispatch2.h b/MdePkg/Include/Protocol/SmmSwDispatch2.h
> index d0db953f06b0..27e91b5fb80f 100644
> --- a/MdePkg/Include/Protocol/SmmSwDispatch2.h
> +++ b/MdePkg/Include/Protocol/SmmSwDispatch2.h
> @@ -60,7 +60,7 @@ typedef struct _EFI_SMM_SW_DISPATCH2_PROTOCOL EFI_SMM_SW_DISPATCH2_PROTOCOL;
> @param[in] This Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> @param[in] DispatchFunction Function to register for handler when the specified software
> SMI is generated.
> - @param[in, out] RegisterContext Pointer to the dispatch function's context.
> + @param[in,out] RegisterContext Pointer to the dispatch function's context.
> The caller fills this context in before calling
> the register function to indicate to the register
> function which Software SMI input value the
> diff --git a/MdePkg/Include/Protocol/SuperIo.h b/MdePkg/Include/Protocol/SuperIo.h
> index 802615030c91..bc7655e27281 100644
> --- a/MdePkg/Include/Protocol/SuperIo.h
> +++ b/MdePkg/Include/Protocol/SuperIo.h
> @@ -45,7 +45,7 @@ typedef struct _EFI_SIO_PROTOCOL EFI_SIO_PROTOCOL;
> The Super I/O driver must track the current state of the Super I/O and enable the
> configuration mode of Super I/O if necessary prior to register access.
> @param[in] Register Register number.
> - @param[in, out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to
> be
> + @param[in,out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to
> be
> written to the Super I/O register. If Write is FALSE, Value is a pointer to the
> destination buffer for the byte of data to be read from the Super I/O register.
>
> diff --git a/MdePkg/Include/Protocol/Supplicant.h b/MdePkg/Include/Protocol/Supplicant.h
> index d78622112583..0c44673482b5 100644
> --- a/MdePkg/Include/Protocol/Supplicant.h
> +++ b/MdePkg/Include/Protocol/Supplicant.h
> @@ -311,7 +311,7 @@ typedef struct {
> RequestBuffer is NULL.
> @param[out] Buffer Pointer to the buffer to hold the built
> packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
> input, it is the buffer size provided by the
> caller. On output, it is the buffer size in
> fact needed to contain the packet.
> @@ -347,7 +347,7 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_SUPPLICANT_PROTOCOL
> instance.
> - @param[in, out] FragmentTable Pointer to a list of fragment. The caller
> + @param[in,out] FragmentTable Pointer to a list of fragment. The caller
> will take responsible to handle the original
> FragmentTable while it may be reallocated in
> Supplicant driver.
> @@ -410,7 +410,7 @@ EFI_STATUS
> @param[in] DataType The type of data.
> @param[out] Data Pointer to the buffer to hold the data.
> Ignored if DataSize is 0.
> - @param[in, out] DataSize Pointer to the buffer size in bytes. On
> + @param[in,out] DataSize Pointer to the buffer size in bytes. On
> input, it is the buffer size provided by the
> caller. On output, it is the buffer size in
> fact needed to contain the packet.
> diff --git a/MdePkg/Include/Protocol/Tcg2Protocol.h b/MdePkg/Include/Protocol/Tcg2Protocol.h
> index f1326a5ef022..7199b6407666 100644
> --- a/MdePkg/Include/Protocol/Tcg2Protocol.h
> +++ b/MdePkg/Include/Protocol/Tcg2Protocol.h
> @@ -143,7 +143,7 @@ typedef struct tdEFI_TCG2_EVENT {
> capability information and state information.
>
> @param[in] This Indicates the calling context
> - @param[in, out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
> + @param[in,out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
> structure and sets the size field to the size of the structure allocated.
> The callee fills in the fields with the EFI protocol capability information
> and the current EFI TCG2 state information up to the number of fields which
> diff --git a/MdePkg/Include/Protocol/Tls.h b/MdePkg/Include/Protocol/Tls.h
> index edcf0e3e728c..24c902530b44 100644
> --- a/MdePkg/Include/Protocol/Tls.h
> +++ b/MdePkg/Include/Protocol/Tls.h
> @@ -376,8 +376,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
> @param[in] DataType TLS session data type.
> - @param[in, out] Data Pointer to session data.
> - @param[in, out] DataSize Total size of session data. On input, it means
> + @param[in,out] Data Pointer to session data.
> + @param[in,out] DataSize Total size of session data. On input, it means
> the size of Data buffer. On output, it means the size
> of copied Data buffer if EFI_SUCCESS, and means the
> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
> @@ -422,7 +422,7 @@ EFI_STATUS
> @param[in] RequestSize Packet size in bytes for the most recently received TLS
> packet. 0 is only valid when RequestBuffer is NULL.
> @param[out] Buffer Pointer to the buffer to hold the built packet.
> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On input, it is
> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On input, it is
> the buffer size provided by the caller. On output, it
> is the buffer size in fact needed to contain the
> packet.
> @@ -456,7 +456,7 @@ EFI_STATUS
> The ProcessPacket () function process each inbound or outbound TLS APP packet.
>
> @param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
> - @param[in, out] FragmentTable Pointer to a list of fragment. The caller will take
> + @param[in,out] FragmentTable Pointer to a list of fragment. The caller will take
> responsible to handle the original FragmentTable while
> it may be reallocated in TLS driver. If CryptMode is
> EfiTlsEncrypt, on input these fragments contain the TLS
> diff --git a/MdePkg/Include/Protocol/TlsConfig.h b/MdePkg/Include/Protocol/TlsConfig.h
> index 8b2a94d41f8e..9b9019338757 100644
> --- a/MdePkg/Include/Protocol/TlsConfig.h
> +++ b/MdePkg/Include/Protocol/TlsConfig.h
> @@ -87,8 +87,8 @@ EFI_STATUS
>
> @param[in] This Pointer to the EFI_TLS_CONFIGURATION_PROTOCOL instance.
> @param[in] DataType Configuration data type.
> - @param[in, out] Data Pointer to configuration data.
> - @param[in, out] DataSize Total size of configuration data. On input, it means
> + @param[in,out] Data Pointer to configuration data.
> + @param[in,out] DataSize Total size of configuration data. On input, it means
> the size of Data buffer. On output, it means the size
> of copied Data buffer if EFI_SUCCESS, and means the
> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
> diff --git a/MdePkg/Include/Protocol/UfsDeviceConfig.h b/MdePkg/Include/Protocol/UfsDeviceConfig.h
> index 34676c7831c5..ae0253ae4f64 100644
> --- a/MdePkg/Include/Protocol/UfsDeviceConfig.h
> +++ b/MdePkg/Include/Protocol/UfsDeviceConfig.h
> @@ -34,8 +34,8 @@ typedef struct _EFI_UFS_DEVICE_CONFIG_PROTOCOL EFI_UFS_DEVICE_CONFIG_PROTOCOL;
> @param[in] DescId The ID of device descriptor.
> @param[in] Index The Index of device descriptor.
> @param[in] Selector The Selector of device descriptor.
> - @param[in, out] Descriptor The buffer of device descriptor to be read or written.
> - @param[in, out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
> + @param[in,out] Descriptor The buffer of device descriptor to be read or written.
> + @param[in,out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
> of the data buffer specified by Descriptor. On output, the number
> of bytes that were actually transferred.
>
> @@ -68,7 +68,7 @@ EFI_STATUS
> @param[in] This The pointer to the EFI_UFS_DEVICE_CONFIG_PROTOCOL instance.
> @param[in] Read The boolean variable to show r/w direction.
> @param[in] FlagId The ID of flag to be read or written.
> - @param[in, out] Flag The buffer to set or clear flag.
> + @param[in,out] Flag The buffer to set or clear flag.
>
> @retval EFI_SUCCESS The flag descriptor is set/clear successfully.
> @retval EFI_INVALID_PARAMETER This is NULL or Flag is NULL.
> @@ -96,8 +96,8 @@ EFI_STATUS
> @param[in] AttrId The ID of Attribute.
> @param[in] Index The Index of Attribute.
> @param[in] Selector The Selector of Attribute.
> - @param[in, out] Attribute The buffer of Attribute to be read or written.
> - @param[in, out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
> + @param[in,out] Attribute The buffer of Attribute to be read or written.
> + @param[in,out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
> data buffer specified by Attribute. On output, the number of bytes
> that were actually transferred.
>
> diff --git a/MdePkg/Include/Protocol/UsbFunctionIo.h b/MdePkg/Include/Protocol/UsbFunctionIo.h
> index e360b604808e..3b0fcba69806 100644
> --- a/MdePkg/Include/Protocol/UsbFunctionIo.h
> +++ b/MdePkg/Include/Protocol/UsbFunctionIo.h
> @@ -343,7 +343,7 @@ EFI_STATUS
> @param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
> @param[in] EndpointIndex Indicates the endpoint.
> @param[in] Direction Direction of the endpoint.
> - @param[in, out] State Boolean, true value indicates that the endpoint
> + @param[in,out] State Boolean, true value indicates that the endpoint
> is in a stalled state, false otherwise.
>
> @retval EFI_SUCCESS The function returned successfully.
> @@ -402,7 +402,7 @@ EFI_STATUS
>
> @param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
> @param[out] Message Indicates the event that initiated this notification.
> - @param[in, out] PayloadSize On input, the size of the memory pointed by
> + @param[in,out] PayloadSize On input, the size of the memory pointed by
> Payload. On output, the amount ofdata returned
> in Payload.
> @param[out] Payload A pointer to EFI_USBFN_MESSAGE_PAYLOAD instance
> @@ -446,14 +446,14 @@ EFI_STATUS
> @param[in] EndpointIndex Indicates the endpoint on which TX or RX transfer
> needs to take place.
> @param[in] Direction Direction of the endpoint.
> - @param[in, out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
> + @param[in,out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
> On input, the size of the Bufferin bytes.
> On output, the amount of data returned in Buffer
> in bytes.
> If Direction is EfiUsbEndpointDirectionDeviceTx:
> On input, the size of the Bufferin bytes.
> On output, the amount of data transmitted in bytes.
> - @param[in, out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
> + @param[in,out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
> The Buffer to return the received data.
> If Directionis EfiUsbEndpointDirectionDeviceTx:
> The Buffer that contains the data to be transmitted.
> @@ -630,9 +630,9 @@ EFI_STATUS
> @param[in] Direction Direction of the endpoint.
> @param[in] PolicyType Policy type the user is trying to retrieve for
> the specified non-control endpoint.
> - @param[in, out] BufferSize On input, the size of Bufferin bytes. On output,
> + @param[in,out] BufferSize On input, the size of Bufferin bytes. On output,
> the amount of data returned in Bufferin bytes.
> - @param[in, out] Buffer A pointer to a buffer to return requested endpoint
> + @param[in,out] Buffer A pointer to a buffer to return requested endpoint
> policy value.
>
> @retval EFI_SUCCESS The function returned successfully.
> diff --git a/MdePkg/Include/Protocol/UserCredential.h b/MdePkg/Include/Protocol/UserCredential.h
> index 986cf44994f1..d1d957330493 100644
> --- a/MdePkg/Include/Protocol/UserCredential.h
> +++ b/MdePkg/Include/Protocol/UserCredential.h
> @@ -83,10 +83,10 @@ EFI_STATUS
> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
>
> @param[in] This Points to this instance of the EFI_USER_CREDENTIAL_PROTOCOL.
> - @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
> + @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
> information will be returned. On exit, points to the width of the
> bitmap returned.
> - @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
> + @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
> information will be returned. On exit, points to the height of the
> bitmap returned
> @param[out] Hii On return, holds the HII database handle.
> diff --git a/MdePkg/Include/Protocol/UserCredential2.h b/MdePkg/Include/Protocol/UserCredential2.h
> index fc64ba544a2b..caec534d61ef 100644
> --- a/MdePkg/Include/Protocol/UserCredential2.h
> +++ b/MdePkg/Include/Protocol/UserCredential2.h
> @@ -81,10 +81,10 @@ EFI_STATUS
> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
>
> @param[in] This Points to this instance of the EFI_USER_CREDENTIAL2_PROTOCOL.
> - @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
> + @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
> information will be returned. On exit, points to the width of the
> bitmap returned.
> - @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
> + @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
> information will be returned. On exit, points to the height of the
> bitmap returned
> @param[out] Hii On return, holds the HII database handle.
> diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h
> index 7dfe35b4990b..516f4222d480 100644
> --- a/MdePkg/Include/Uefi/UefiSpec.h
> +++ b/MdePkg/Include/Uefi/UefiSpec.h
> @@ -169,7 +169,7 @@ typedef struct {
> 0x80000000..0xFFFFFFFF are reserved for use by UEFI OS loaders
> that are provided by operating system vendors.
> @param[in] Pages The number of contiguous 4 KB pages to allocate.
> - @param[in, out] Memory The pointer to a physical address. On input, the way in which the address is
> + @param[in,out] Memory The pointer to a physical address. On input, the way in which the address is
> used depends on the value of Type.
>
> @retval EFI_SUCCESS The requested pages were allocated.
> @@ -214,7 +214,7 @@ EFI_STATUS
> /**
> Returns the current memory map.
>
> - @param[in, out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
> + @param[in,out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
> On input, this is the size of the buffer allocated by the caller.
> On output, it is the size of the buffer returned by the firmware if
> the buffer was large enough, or the size of the buffer needed to contain
> @@ -391,7 +391,7 @@ EFI_STATUS
> Determines the new virtual address that is to be used on subsequent memory accesses.
>
> @param[in] DebugDisposition Supplies type information for the pointer being converted.
> - @param[in, out] Address A pointer to a pointer that is to be fixed to be the value needed
> + @param[in,out] Address A pointer to a pointer that is to be fixed to be the value needed
> for the new virtual address mappings being applied.
>
> @retval EFI_SUCCESS The pointer pointed to by Address was modified.
> @@ -650,7 +650,7 @@ VOID
> @param[in] VendorGuid A unique identifier for the vendor.
> @param[out] Attributes If not NULL, a pointer to the memory location to return the
> attributes bitmask for the variable.
> - @param[in, out] DataSize On input, the size in bytes of the return Data buffer.
> + @param[in,out] DataSize On input, the size in bytes of the return Data buffer.
> On output the size of data returned in Data.
> @param[out] Data The buffer to return the contents of the variable. May be NULL
> with a zero DataSize in order to determine the size buffer needed.
> @@ -679,12 +679,12 @@ EFI_STATUS
> /**
> Enumerates the current variable names.
>
> - @param[in, out] VariableNameSize The size of the VariableName buffer. The size must be large
> + @param[in,out] VariableNameSize The size of the VariableName buffer. The size must be large
> enough to fit input string supplied in VariableName buffer.
> - @param[in, out] VariableName On input, supplies the last VariableName that was returned
> + @param[in,out] VariableName On input, supplies the last VariableName that was returned
> by GetNextVariableName(). On output, returns the Nullterminated
> string of the current variable.
> - @param[in, out] VendorGuid On input, supplies the last VendorGuid that was returned by
> + @param[in,out] VendorGuid On input, supplies the last VendorGuid that was returned by
> GetNextVariableName(). On output, returns the
> VendorGuid of the current variable.
>
> @@ -1155,7 +1155,7 @@ typedef enum {
> InstallMultipleProtocolInterfaces() be used in place of
> InstallProtocolInterface()
>
> - @param[in, out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
> + @param[in,out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
> @param[in] Protocol The numeric ID of the protocol interface.
> @param[in] InterfaceType Indicates whether Interface is supplied in native form.
> @param[in] Interface A pointer to the protocol interface.
> @@ -1180,7 +1180,7 @@ EFI_STATUS
> /**
> Installs one or more protocol interfaces into the boot services environment.
>
> - @param[in, out] Handle The pointer to a handle to install the new protocol interfaces on,
> + @param[in,out] Handle The pointer to a handle to install the new protocol interfaces on,
> or a pointer to NULL if a new handle is to be allocated.
> @param ... A variable argument list containing pairs of protocol GUIDs and protocol
> interfaces.
> @@ -1479,7 +1479,7 @@ typedef enum {
> @param[in] SearchType Specifies which handle(s) are to be returned.
> @param[in] Protocol Specifies the protocol to search by.
> @param[in] SearchKey Specifies the search key.
> - @param[in, out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
> + @param[in,out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
> the array returned in Buffer (if the buffer was large enough) or the
> size, in bytes, of the buffer needed to obtain the array (if the buffer was
> not large enough).
> @@ -1509,7 +1509,7 @@ EFI_STATUS
> Locates the handle to a device on the device path that supports the specified protocol.
>
> @param[in] Protocol Specifies the protocol to search for.
> - @param[in, out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
> + @param[in,out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
> path pointer is modified to point to the remaining part of the device
> path.
> @param[out] Device A pointer to the returned device handle.
> diff --git a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
> index e6f479b829f6..dfdee0b5d2c0 100644
> --- a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
> +++ b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
> @@ -28,7 +28,7 @@ typedef struct {
> the registered guid and Handler list. When it is initialized, it will be directly returned.
> Or, HandlerInfo table will be initialized in this function.
>
> - @param[in, out] InfoPointer The pointer to the handler information structure.
> + @param[in,out] InfoPointer The pointer to the handler information structure.
>
> @retval RETURN_SUCCESS HandlerInfo table can be used to store guid and function tables.
> @retval RETURN_OUT_OF_RESOURCES HandlerInfo table address is not writable.
> diff --git a/MdePkg/Library/BaseLib/QuickSort.c b/MdePkg/Library/BaseLib/QuickSort.c
> index d9f0e9a0f475..a7b7d0c6cd2b 100644
> --- a/MdePkg/Library/BaseLib/QuickSort.c
> +++ b/MdePkg/Library/BaseLib/QuickSort.c
> @@ -22,7 +22,7 @@
>
> if Count is < 2 then perform no action.
>
> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
> on return a buffer of sorted elements
> @param[in] Count the number of elements in the buffer to sort
> @param[in] ElementSize Size of an element in bytes
> diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c b/MdePkg/Library/BasePcdLibNull/PcdLib.c
> index a214371c3fdf..39303cf429a7 100644
> --- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
> +++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c
> @@ -470,7 +470,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -645,7 +645,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set a value from.
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -819,7 +819,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer that was set.
> @@ -870,7 +870,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> @@ -923,7 +923,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -979,7 +979,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> index 417096f33493..63339fb4a627 100644
> --- a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> +++ b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
> @@ -14,8 +14,8 @@
> instruction sets.
>
> @param[in] Reloc Pointer to the relocation record.
> - @param[in, out] Fixup Pointer to the address to fix up.
> - @param[in, out] FixupData Pointer to a buffer to log the fixups.
> + @param[in,out] Fixup Pointer to the address to fix up.
> + @param[in,out] FixupData Pointer to a buffer to log the fixups.
> @param[in] Adjust The offset to adjust the fixup.
>
> @return Status code.
> @@ -117,8 +117,8 @@ PeCoffLoaderImageFormatSupported (
> space for runtime calls.
>
> @param[in] Reloc The pointer to the relocation record.
> - @param[in, out] Fixup The pointer to the address to fix up.
> - @param[in, out] FixupData The pointer to a buffer to log the fixups.
> + @param[in,out] Fixup The pointer to the address to fix up.
> + @param[in,out] FixupData The pointer to a buffer to log the fixups.
> @param[in] Adjust The offset to adjust the fixup.
>
> @return Status code.
> diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c b/MdePkg/Library/DxePcdLib/DxePcdLib.c
> index b2a8bf22a365..c371f26f24c1 100644
> --- a/MdePkg/Library/DxePcdLib/DxePcdLib.c
> +++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c
> @@ -554,7 +554,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -731,7 +731,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set a value from.
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -926,7 +926,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -977,7 +977,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> @@ -1030,7 +1030,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -1086,7 +1086,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> index c538f157a242..2436e2c8f62e 100644
> --- a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> +++ b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
> @@ -28,7 +28,7 @@ typedef struct {
> Build guid hob for the global memory to store the registered guid and Handler list.
> If GuidHob exists, HandlerInfo will be directly got from Guid hob data.
>
> - @param[in, out] InfoPointer The pointer to pei handler information structure.
> + @param[in,out] InfoPointer The pointer to pei handler information structure.
>
> @retval RETURN_SUCCESS Build Guid hob for the global memory space to store guid and function tables.
> @retval RETURN_OUT_OF_RESOURCES No enough memory to allocated.
> diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> index 166d4a6f32d0..f16c1f8715a0 100644
> --- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> +++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
> @@ -544,7 +544,7 @@ LibPcdSet64S (
> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -721,7 +721,7 @@ LibPcdSetEx64S (
> @param[in] Guid Pointer to a 128-bit unique value that
> designates which namespace to set a value from.
> @param[in] TokenNumber The PCD token number to set a current value for.
> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to set.
>
> @return The status of the set operation.
> @@ -918,7 +918,7 @@ LibPcdGetNextTokenSpace (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -969,7 +969,7 @@ LibPatchPcdSetPtr (
> @param[out] PatchVariable A pointer to the global variable in a module that is
> the target of the set operation.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> @@ -1022,7 +1022,7 @@ LibPatchPcdSetPtrS (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return Return the pointer to the buffer been set.
> @@ -1078,7 +1078,7 @@ LibPatchPcdSetPtrAndSize (
> the target of the set operation.
> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>
> @return The status of the set operation.
> diff --git a/MdePkg/Library/SmmIoLib/SmmIoLib.c b/MdePkg/Library/SmmIoLib/SmmIoLib.c
> index ad4bfff68c8a..070a0c4f7b2a 100644
> --- a/MdePkg/Library/SmmIoLib/SmmIoLib.c
> +++ b/MdePkg/Library/SmmIoLib/SmmIoLib.c
> @@ -155,9 +155,9 @@ SmmIsMmioValid (
> /**
> Merge continuous entries whose type is EfiGcdMemoryTypeMemoryMappedIo.
>
> - @param[in, out] GcdMemoryMap A pointer to the buffer in which firmware places
> + @param[in,out] GcdMemoryMap A pointer to the buffer in which firmware places
> the current GCD memory map.
> - @param[in, out] NumberOfDescriptors A pointer to the number of the
> + @param[in,out] NumberOfDescriptors A pointer to the number of the
> GcdMemoryMap buffer. On input, this is the number of
> the current GCD memory map. On output,
> it is the number of new GCD memory map after merge.
> diff --git a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> index ff143f00ab9a..1ba604b0cdda 100644
> --- a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> +++ b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
> @@ -723,7 +723,7 @@ PeriodicSmiDispatchFunctionOnCpu (
> released to notify the CPU that is running the SMM Foundation that the periodic
> SMI handler execution has finished its execution.
>
> - @param[in, out] Buffer A pointer to the context for the periodic SMI handler.
> + @param[in,out] Buffer A pointer to the context for the periodic SMI handler.
>
> **/
> VOID
> @@ -758,10 +758,10 @@ PeriodicSmiDispatchFunctionWithLock (
> SmiHandlerRegister().
> @param[in] Context Points to an optional handler context which was
> specified when the handler was registered.
> - @param[in, out] CommBuffer A pointer to a collection of data in memory that
> + @param[in,out] CommBuffer A pointer to a collection of data in memory that
> will be conveyed from a non-SMM environment into
> an SMM environment.
> - @param[in, out] CommBufferSize The size of the CommBuffer.
> + @param[in,out] CommBufferSize The size of the CommBuffer.
>
> @retval EFI_SUCCESS The interrupt was handled and quiesced.
> No other handlers should still be called.
> @@ -863,7 +863,7 @@ PeriodicSmiDispatchFunction (
> /**
> This function enables a periodic SMI handler.
>
> - @param[in, out] DispatchHandle A pointer to the handle associated with the
> + @param[in,out] DispatchHandle A pointer to the handle associated with the
> enabled periodic SMI handler. This is an
> optional parameter that may be NULL. If it is
> NULL, then the handle will not be returned,
> diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> index 86678e965d99..8fe52cab316f 100644
> --- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> +++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
> @@ -697,8 +697,8 @@ FileHandleSetSize (
> if Destination's current length (including NULL terminator) is already more then
> CurrentSize, then ASSERT()
>
> - @param[in, out] Destination The String to append onto
> - @param[in, out] CurrentSize on call the number of bytes in Destination. On
> + @param[in,out] Destination The String to append onto
> + @param[in,out] CurrentSize on call the number of bytes in Destination. On
> return possibly the new size (still in bytes). if NULL
> then allocate whatever is needed.
> @param[in] Source The String to append from
> @@ -907,7 +907,7 @@ FileHandleGetFileName (
> maintained and not changed for all operations with the same file.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
> + @param[in,out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
>
> @return The line of text from the file.
>
> @@ -951,15 +951,15 @@ FileHandleReturnLine (
> read a CHAR_NULL character will be returned in buffer.
>
> @param[in] Handle FileHandle to read from.
> - @param[in, out] Buffer The pointer to buffer to read into.
> - @param[in, out] Size The pointer to number of bytes in Buffer.
> + @param[in,out] Buffer The pointer to buffer to read into.
> + @param[in,out] Size The pointer to number of bytes in Buffer.
> @param[in] Truncate If the buffer is large enough, this has no effect.
> If the buffer is is too small and Truncate is TRUE,
> the line will be truncated.
> If the buffer is is too small and Truncate is FALSE,
> then no read will occur.
>
> - @param[in, out] Ascii Boolean value for indicating whether the file is
> + @param[in,out] Ascii Boolean value for indicating whether the file is
> Ascii (TRUE) or UCS2 (FALSE).
>
> @retval EFI_SUCCESS The operation was successful. The line is stored in
> diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> index a33cadd71646..af74ab732b21 100644
> --- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> +++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> @@ -81,12 +81,12 @@ typedef struct {
> is greater than zero, then this function will return
> EFI_TIMEOUT if the time required to execute the SCSI
> Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated by
> + @param[in,out] SenseData A pointer to sense data that was generated by
> the execution of the SCSI Request Packet. This
> buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter is
> optional and may be NULL.
> - @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
> + @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
> the SenseData buffer. On output, a pointer to
> the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
> @@ -199,12 +199,12 @@ ScsiTestUnitReadyCommand (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI
> @@ -218,12 +218,12 @@ ScsiTestUnitReadyCommand (
> See the EFI SCSI I/O Protocol in the UEFI
> Specification for details on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If InquiryDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
> of the InquiryDataBuffer buffer.
> On output, a pointer to the number of bytes
> written to the InquiryDataBuffer buffer.
> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI
> @@ -366,12 +366,12 @@ ScsiInquiryCommandEx (
> See the EFI SCSI I/O Protocol in the UEFI
> Specification for details on the possible
> return values.
> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If InquiryDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
> of the InquiryDataBuffer buffer.
> On output, a pointer to the number of bytes
> written to the InquiryDataBuffer buffer.
> @@ -464,12 +464,12 @@ ScsiInquiryCommand (
> If Timeout is greater than zero, then this function
> will return EFI_TIMEOUT if the time required to
> execute the SCSI Request Packet is greater than Timeout.
> - @param[in, out] SenseData A pointer to sense data that was generated
> + @param[in,out] SenseData A pointer to sense data that was generated
> by the execution of the SCSI Request Packet.
> This buffer must be allocated by the caller.
> If SenseDataLength is 0, then this parameter
> is optional and may be NULL.
> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
> On output, the number of bytes written to the SenseData buffer.
> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
> produces the SCSI bus containing the SCSI target
> @@ -482,12 +482,12 @@ ScsiInquiryCommand (
> on the SCSI Host Controller. See the EFI SCSI
> I/O Protocol in the UEFI Specification for details
> on the possible return values.
> - @param[in, out] DataBuffer A pointer to data that was generated by the
> + @param[in,out] DataBuffer A pointer to data that was generated by the
> execution of the SCSI Request Packet. This
> buffer must be allocated by the caller. If
> DataLength is 0, then this parameter is optional
> and may be NULL.
> - @param[in, out] DataLength On input, a pointer to the length in bytes of
> + @param[in,out] DataLength On input, a pointer to the length in bytes of
> the DataBuffer buffer. On output, a pointer
> to the number of bytes written to the DataBuffer
> buffer.
> @@ -602,8 +602,8 @@ ScsiModeSense10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
>
> @@ -687,12 +687,12 @@ ScsiRequestSenseCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @@ -790,12 +790,12 @@ ScsiReadCapacityCommand (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] Pmi Partial medium indicator.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @@ -896,12 +896,12 @@ ScsiReadCapacity16Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 10 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 10 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -995,12 +995,12 @@ ScsiRead10Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -1095,12 +1095,12 @@ ScsiWrite10Command (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -1194,12 +1194,12 @@ ScsiRead16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>
> @@ -1293,8 +1293,8 @@ ScsiWrite16Command (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to use.
> @@ -1302,7 +1302,7 @@ ScsiWrite16Command (
> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
> SECURITY PROTOCOL IN command.
> @param[in] DataLength The size in bytes of the data buffer.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> @param[out] TransferLength A pointer to a buffer to store the size in
> bytes of the data written to the data buffer.
>
> @@ -1408,8 +1408,8 @@ ScsiSecurityProtocolInCommand (
>
> @param[in] ScsiIo SCSI IO Protocol to use.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> @param[in] SecurityProtocol The Security Protocol to use.
> @@ -1417,7 +1417,7 @@ ScsiSecurityProtocolInCommand (
> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
> SECURITY PROTOCOL OUT command.
> @param[in] DataLength The size in bytes of the transfer data.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
>
> @retval EFI_SUCCESS Command is executed successfully.
> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
> @@ -1573,12 +1573,12 @@ ScsiLibNotify (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -1756,12 +1756,12 @@ ScsiRead10CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -1939,12 +1939,12 @@ ScsiWrite10CommandEx (
>
> @param[in] ScsiIo A pointer to SCSI IO protocol.
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer Read 16 command data.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer Read 16 command data.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> @@ -2122,12 +2122,12 @@ ScsiRead16CommandEx (
>
> @param[in] ScsiIo SCSI IO Protocol to use
> @param[in] Timeout The length of timeout period.
> - @param[in, out] SenseData A pointer to output sense data.
> - @param[in, out] SenseDataLength The length of output sense data.
> + @param[in,out] SenseData A pointer to output sense data.
> + @param[in,out] SenseDataLength The length of output sense data.
> @param[out] HostAdapterStatus The status of Host Adapter.
> @param[out] TargetStatus The status of the target.
> - @param[in, out] DataBuffer A pointer to a data buffer.
> - @param[in, out] DataLength The length of data buffer.
> + @param[in,out] DataBuffer A pointer to a data buffer.
> + @param[in,out] DataLength The length of data buffer.
> @param[in] StartLba The start address of LBA.
> @param[in] SectorSize The number of contiguous logical blocks
> of data that shall be transferred.
> --
> 2.30.2
>
>
>
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
2023-03-14 20:38 ` Michael D Kinney
@ 2023-03-14 21:00 ` Rebecca Cran
0 siblings, 0 replies; 7+ messages in thread
From: Rebecca Cran @ 2023-03-14 21:00 UTC (permalink / raw)
To: devel, michael.d.kinney, quic_rcran@quicinc.com, Gao, Liming,
Liu, Zhiguang
Cc: Rebecca Cran
We could run a build with `-t CLANG38` with a modified tools_def.txt
that includes `
-Wdocumentation-pedantic`
--
Rebecca Cran
On 3/14/23 2:38 PM, Michael D Kinney wrote:
> Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>
>
> Is there a tool we can run in CI to verify proper Doxygen syntax?
>
> Mike
>
>> -----Original Message-----
>> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Rebecca Cran
>> Sent: Monday, February 20, 2023 10:46 AM
>> To: devel@edk2.groups.io; Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming <gaoliming@byosoft.com.cn>;
>> Liu, Zhiguang <zhiguang.liu@intel.com>
>> Cc: Rebecca Cran <rebecca@quicinc.com>
>> Subject: [edk2-devel] [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out]
>>
>> There isn't supposed to be whitespace for "@param [in,out]" between "in"
>> and "out". clang generates the following warning:
>>
>> test.c:8:9: warning: whitespace is not allowed in parameter passing direction [-Wdocumentation-pedantic]
>> @param [in, out] argv Array of arguments.
>> ^~~~~~~~~
>> [in,out]
>>
>> Update the documentation blocks in MdePkg.
>>
>> Signed-off-by: Rebecca Cran <rebecca@quicinc.com>
>> ---
>> MdePkg/Include/Library/BaseLib.h | 4 +-
>> MdePkg/Include/Library/FileHandleLib.h | 12 +-
>> MdePkg/Include/Library/PcdLib.h | 14 +--
>> MdePkg/Include/Library/SmmPeriodicSmiLib.h | 2 +-
>> MdePkg/Include/Library/UefiScsiLib.h | 124 ++++++++++----------
>> MdePkg/Include/Ppi/CpuIo.h | 2 +-
>> MdePkg/Include/Ppi/Graphics.h | 2 +-
>> MdePkg/Include/Ppi/Pcd.h | 10 +-
>> MdePkg/Include/Ppi/PiPcd.h | 2 +-
>> MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h | 2 +-
>> MdePkg/Include/Protocol/BlockIo2.h | 4 +-
>> MdePkg/Include/Protocol/BlockIoCrypto.h | 6 +-
>> MdePkg/Include/Protocol/BluetoothHc.h | 4 +-
>> MdePkg/Include/Protocol/BluetoothIo.h | 4 +-
>> MdePkg/Include/Protocol/BluetoothLeConfig.h | 10 +-
>> MdePkg/Include/Protocol/CcMeasurement.h | 2 +-
>> MdePkg/Include/Protocol/CpuIo2.h | 2 +-
>> MdePkg/Include/Protocol/Eap.h | 2 +-
>> MdePkg/Include/Protocol/EapConfiguration.h | 4 +-
>> MdePkg/Include/Protocol/EapManagement.h | 2 +-
>> MdePkg/Include/Protocol/EapManagement2.h | 8 +-
>> MdePkg/Include/Protocol/EraseBlock.h | 2 +-
>> MdePkg/Include/Protocol/FirmwareManagement.h | 6 +-
>> MdePkg/Include/Protocol/I2cEnumerate.h | 2 +-
>> MdePkg/Include/Protocol/IpSec.h | 16 +--
>> MdePkg/Include/Protocol/IpSecConfig.h | 6 +-
>> MdePkg/Include/Protocol/Kms.h | 72 ++++++------
>> MdePkg/Include/Protocol/MmCommunication2.h | 6 +-
>> MdePkg/Include/Protocol/MmSwDispatch.h | 2 +-
>> MdePkg/Include/Protocol/Mtftp6.h | 2 +-
>> MdePkg/Include/Protocol/Pcd.h | 8 +-
>> MdePkg/Include/Protocol/PiPcd.h | 2 +-
>> MdePkg/Include/Protocol/S3SaveState.h | 4 +-
>> MdePkg/Include/Protocol/Shell.h | 8 +-
>> MdePkg/Include/Protocol/SmartCardEdge.h | 12 +-
>> MdePkg/Include/Protocol/SmartCardReader.h | 10 +-
>> MdePkg/Include/Protocol/Smbios.h | 4 +-
>> MdePkg/Include/Protocol/SmmSwDispatch2.h | 2 +-
>> MdePkg/Include/Protocol/SuperIo.h | 2 +-
>> MdePkg/Include/Protocol/Supplicant.h | 6 +-
>> MdePkg/Include/Protocol/Tcg2Protocol.h | 2 +-
>> MdePkg/Include/Protocol/Tls.h | 8 +-
>> MdePkg/Include/Protocol/TlsConfig.h | 4 +-
>> MdePkg/Include/Protocol/UfsDeviceConfig.h | 10 +-
>> MdePkg/Include/Protocol/UsbFunctionIo.h | 12 +-
>> MdePkg/Include/Protocol/UserCredential.h | 4 +-
>> MdePkg/Include/Protocol/UserCredential2.h | 4 +-
>> MdePkg/Include/Uefi/UefiSpec.h | 22 ++--
>> MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c | 2 +-
>> MdePkg/Library/BaseLib/QuickSort.c | 2 +-
>> MdePkg/Library/BasePcdLibNull/PcdLib.c | 12 +-
>> MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c | 8 +-
>> MdePkg/Library/DxePcdLib/DxePcdLib.c | 12 +-
>> MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c | 2 +-
>> MdePkg/Library/PeiPcdLib/PeiPcdLib.c | 12 +-
>> MdePkg/Library/SmmIoLib/SmmIoLib.c | 4 +-
>> MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c | 8 +-
>> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c | 12 +-
>> MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 124 ++++++++++----------
>> 59 files changed, 329 insertions(+), 329 deletions(-)
>>
>> diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/BaseLib.h
>> index 8f2df76c29a3..0dee0f58aa75 100644
>> --- a/MdePkg/Include/Library/BaseLib.h
>> +++ b/MdePkg/Include/Library/BaseLib.h
>> @@ -2482,7 +2482,7 @@ BcdToDecimal8 (
>> /**
>> Removes the last directory or file entry in a path.
>>
>> - @param[in, out] Path The pointer to the path to modify.
>> + @param[in,out] Path The pointer to the path to modify.
>>
>> @retval FALSE Nothing was found to remove.
>> @retval TRUE A directory or file was removed.
>> @@ -2930,7 +2930,7 @@ INTN
>>
>> if Count is < 2 then perform no action.
>>
>> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
>> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
>> on return a buffer of sorted elements
>> @param[in] Count the number of elements in the buffer to sort
>> @param[in] ElementSize Size of an element in bytes
>> diff --git a/MdePkg/Include/Library/FileHandleLib.h b/MdePkg/Include/Library/FileHandleLib.h
>> index 1a238edee38c..2ea97c317c27 100644
>> --- a/MdePkg/Include/Library/FileHandleLib.h
>> +++ b/MdePkg/Include/Library/FileHandleLib.h
>> @@ -78,7 +78,7 @@ FileHandleSetInfo (
>> EFI_FILE_INFO is the structure returned as the directory entry.
>>
>> @param[in] FileHandle The opened file handle.
>> - @param[in, out] BufferSize On input, the size of buffer in bytes. On return,
>> + @param[in,out] BufferSize On input, the size of buffer in bytes. On return,
>> the number of bytes written.
>> @param[out] Buffer The buffer to put read data into.
>>
>> @@ -109,7 +109,7 @@ FileHandleRead (
>> opened directories are not supported.
>>
>> @param[in] FileHandle The opened file for writing.
>> - @param[in, out] BufferSize On input, the number of bytes in Buffer. On output,
>> + @param[in,out] BufferSize On input, the number of bytes in Buffer. On output,
>> the number of bytes written.
>> @param[in] Buffer The buffer containing data to write is stored.
>>
>> @@ -381,15 +381,15 @@ FileHandleGetFileName (
>> read a CHAR_NULL character will be returned in buffer.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Buffer The pointer to buffer to read into.
>> - @param[in, out] Size The pointer to number of bytes in Buffer.
>> + @param[in,out] Buffer The pointer to buffer to read into.
>> + @param[in,out] Size The pointer to number of bytes in Buffer.
>> @param[in] Truncate If the buffer is large enough, this has no effect.
>> If the buffer is is too small and Truncate is TRUE,
>> the line will be truncated.
>> If the buffer is is too small and Truncate is FALSE,
>> then no read will occur.
>>
>> - @param[in, out] Ascii Boolean value for indicating whether the file is
>> + @param[in,out] Ascii Boolean value for indicating whether the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @retval EFI_SUCCESS The operation was successful. The line is stored in
>> @@ -418,7 +418,7 @@ FileHandleReadLine (
>> maintained and not changed for all operations with the same file.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Ascii Boolean value for indicating whether the file is
>> + @param[in,out] Ascii Boolean value for indicating whether the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @return The line of text from the file.
>> diff --git a/MdePkg/Include/Library/PcdLib.h b/MdePkg/Include/Library/PcdLib.h
>> index 4b103f0753c5..86739a3b2bd1 100644
>> --- a/MdePkg/Include/Library/PcdLib.h
>> +++ b/MdePkg/Include/Library/PcdLib.h
>> @@ -1158,7 +1158,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -1303,7 +1303,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set a value from.
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -1354,7 +1354,7 @@ LibPcdSetExBoolS (
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being set.
>> @param[in] TokenDataSize The size, in bytes, of the data being set.
>>
>> **/
>> @@ -1474,7 +1474,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the Buffer that was set.
>> @@ -1506,7 +1506,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> @@ -1540,7 +1540,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the Buffer that was set.
>> @@ -1575,7 +1575,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Include/Library/SmmPeriodicSmiLib.h b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> index 83d9bdde0eb8..dd3745d65af8 100644
>> --- a/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> +++ b/MdePkg/Include/Library/SmmPeriodicSmiLib.h
>> @@ -104,7 +104,7 @@ VOID
>> /**
>> This function enables a periodic SMI handler.
>>
>> - @param[in, out] DispatchHandle A pointer to the handle associated with the
>> + @param[in,out] DispatchHandle A pointer to the handle associated with the
>> enabled periodic SMI handler. This is an
>> optional parameter that may be NULL. If it is
>> NULL, then the handle will not be returned,
>> diff --git a/MdePkg/Include/Library/UefiScsiLib.h b/MdePkg/Include/Library/UefiScsiLib.h
>> index da6ac2df68e7..90db37456ad2 100644
>> --- a/MdePkg/Include/Library/UefiScsiLib.h
>> +++ b/MdePkg/Include/Library/UefiScsiLib.h
>> @@ -39,12 +39,12 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
>> is greater than zero, then this function will return
>> EFI_TIMEOUT if the time required to execute the SCSI
>> Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated by
>> + @param[in,out] SenseData A pointer to sense data that was generated by
>> the execution of the SCSI Request Packet. This
>> buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter is
>> optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
>> + @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
>> the SenseData buffer. On output, a pointer to
>> the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
>> @@ -122,12 +122,12 @@ ScsiTestUnitReadyCommand (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI
>> @@ -141,12 +141,12 @@ ScsiTestUnitReadyCommand (
>> See the EFI SCSI I/O Protocol in the UEFI
>> Specification for details on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If InquiryDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
>> of the InquiryDataBuffer buffer.
>> On output, a pointer to the number of bytes
>> written to the InquiryDataBuffer buffer.
>> @@ -223,12 +223,12 @@ ScsiInquiryCommand (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI
>> @@ -242,12 +242,12 @@ ScsiInquiryCommand (
>> See the EFI SCSI I/O Protocol in the UEFI
>> Specification for details on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If InquiryDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
>> of the InquiryDataBuffer buffer.
>> On output, a pointer to the number of bytes
>> written to the InquiryDataBuffer buffer.
>> @@ -329,12 +329,12 @@ ScsiInquiryCommandEx (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI target
>> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
>> on the SCSI Host Controller. See the EFI SCSI
>> I/O Protocol in the UEFI Specification for details
>> on the possible return values.
>> - @param[in, out] DataBuffer A pointer to data that was generated by the
>> + @param[in,out] DataBuffer A pointer to data that was generated by the
>> execution of the SCSI Request Packet. This
>> buffer must be allocated by the caller. If
>> DataLength is 0, then this parameter is optional
>> and may be NULL.
>> - @param[in, out] DataLength On input, a pointer to the length in bytes of
>> + @param[in,out] DataLength On input, a pointer to the length in bytes of
>> the DataBuffer buffer. On output, a pointer
>> to the number of bytes written to the DataBuffer
>> buffer.
>> @@ -420,8 +420,8 @@ ScsiModeSense10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>>
>> @@ -469,12 +469,12 @@ ScsiRequestSenseCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @@ -527,12 +527,12 @@ ScsiReadCapacityCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @@ -586,12 +586,12 @@ ScsiReadCapacity16Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 10 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 10 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -646,12 +646,12 @@ ScsiRead10Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -706,12 +706,12 @@ ScsiWrite10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -766,12 +766,12 @@ ScsiRead16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -825,8 +825,8 @@ ScsiWrite16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to use.
>> @@ -834,7 +834,7 @@ ScsiWrite16Command (
>> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL IN command.
>> @param[in] DataLength The size in bytes of the data buffer.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> @param[out] TransferLength A pointer to a buffer to store the size in
>> bytes of the data written to the data buffer.
>>
>> @@ -889,8 +889,8 @@ ScsiSecurityProtocolInCommand (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to use.
>> @@ -898,7 +898,7 @@ ScsiSecurityProtocolInCommand (
>> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL OUT command.
>> @param[in] DataLength The size in bytes of the transfer data.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
>> @@ -960,12 +960,12 @@ ScsiSecurityProtocolOutCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -1049,12 +1049,12 @@ ScsiRead10CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -1138,12 +1138,12 @@ ScsiWrite10CommandEx (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -1227,12 +1227,12 @@ ScsiRead16CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
>> index 193a78e3c256..5e2ca4edbc22 100644
>> --- a/MdePkg/Include/Ppi/CpuIo.h
>> +++ b/MdePkg/Include/Ppi/CpuIo.h
>> @@ -46,7 +46,7 @@ typedef enum {
>> @param[in] Width The width of the access. Enumerated in bytes.
>> @param[in] Address The physical address of the access.
>> @param[in] Count The number of accesses to perform.
>> - @param[in, out] Buffer A pointer to the buffer of data.
>> + @param[in,out] Buffer A pointer to the buffer of data.
>>
>> @retval EFI_SUCCESS The function completed successfully.
>> @retval EFI_NOT_YET_AVAILABLE The service has not been installed.
>> diff --git a/MdePkg/Include/Ppi/Graphics.h b/MdePkg/Include/Ppi/Graphics.h
>> index 3854f6c371c2..e8c1bc14b0ac 100644
>> --- a/MdePkg/Include/Ppi/Graphics.h
>> +++ b/MdePkg/Include/Ppi/Graphics.h
>> @@ -48,7 +48,7 @@ EFI_STATUS
>> The GraphicsPpiGetMode returns the mode information supported by the Graphics PEI
>> Module.
>>
>> - @param[in, out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>> + @param[in,out] Mode Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.
>>
>> @retval EFI_SUCCESS Valid mode information was returned.
>> @retval EFI_INVALID_PARAMETER The Mode parameter is not valid.
>> diff --git a/MdePkg/Include/Ppi/Pcd.h b/MdePkg/Include/Ppi/Pcd.h
>> index d36a7f106cc8..3e6556314d1b 100644
>> --- a/MdePkg/Include/Ppi/Pcd.h
>> +++ b/MdePkg/Include/Ppi/Pcd.h
>> @@ -420,7 +420,7 @@ EFI_STATUS
>> If it is not, an error will be returned.
>>
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
>> + @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
>> On input, if the SizeOfValue is greater than the maximum size supported
>> for this TokenNumber then the output value of SizeOfValue will reflect
>> the maximum size supported for this TokenNumber.
>> @@ -578,7 +578,7 @@ EFI_STATUS
>>
>> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
>> value.
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfValue A pointer to the length of the value being set for the PCD token.
>> + @param[in,out] SizeOfValue A pointer to the length of the value being set for the PCD token.
>> On input, if the SizeOfValue is greater than the maximum size supported
>> for this TokenNumber then the output value of SizeOfValue will reflect
>> the maximum size supported for this TokenNumber.
>> @@ -638,7 +638,7 @@ EFI_STATUS
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being set.
>> @param[in] TokenDataSize The size, in bytes, of the data being set.
>>
>> @retval VOID
>> @@ -712,7 +712,7 @@ EFI_STATUS
>> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
>> value.
>> This is an optional parameter that may be NULL. If this parameter is NULL, then a
>> request
>> is being made to retrieve tokens from the default token space.
>> - @param[in, out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
>> + @param[in,out] TokenNumber A pointer to the PCD token number to use to find the subsequent token number.
>>
>> @retval EFI_SUCCESS The PCD service has retrieved the next valid token number.
>> @retval EFI_NOT_FOUND The PCD service could not find data from the requested token number.
>> @@ -731,7 +731,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
>> namespace from which the search will start. On output, it designates the next valid
>> token namespace on the platform. If *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned. If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Ppi/PiPcd.h b/MdePkg/Include/Ppi/PiPcd.h
>> index 8d0f95eb27cc..8b137f2ca9e2 100644
>> --- a/MdePkg/Include/Ppi/PiPcd.h
>> +++ b/MdePkg/Include/Ppi/PiPcd.h
>> @@ -387,7 +387,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token
>> namespace from which the search will start. On output, it designates the next valid
>> token namespace on the platform. If *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned. If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> index 9e134200da54..f25c3a7cd641 100644
>> --- a/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> +++ b/MdePkg/Include/Protocol/AcpiSystemDescriptionTable.h
>> @@ -162,7 +162,7 @@ EFI_STATUS
>> Return the child ACPI objects.
>>
>> @param[in] ParentHandle Parent handle.
>> - @param[in, out] Handle On entry, points to the previously returned handle or NULL to start with the
>> first
>> + @param[in,out] Handle On entry, points to the previously returned handle or NULL to start with the
>> first
>> handle. On return, points to the next returned ACPI handle or NULL if there are
>> no
>> child objects.
>>
>> diff --git a/MdePkg/Include/Protocol/BlockIo2.h b/MdePkg/Include/Protocol/BlockIo2.h
>> index d25f51f73354..9bd5e7a6ddd9 100644
>> --- a/MdePkg/Include/Protocol/BlockIo2.h
>> +++ b/MdePkg/Include/Protocol/BlockIo2.h
>> @@ -72,7 +72,7 @@ EFI_STATUS
>> @param[in] MediaId Id of the media, changes every time the media is
>> replaced.
>> @param[in] Lba The starting Logical Block Address to read from.
>> - @param[in, out] Token A pointer to the token associated with the transaction.
>> + @param[in,out] Token A pointer to the token associated with the transaction.
>> @param[in] BufferSize Size of Buffer, must be a multiple of device block size.
>> @param[out] Buffer A pointer to the destination buffer for the data. The
>> caller is responsible for either having implicit or
>> @@ -116,7 +116,7 @@ EFI_STATUS
>> @param[in] Lba The starting logical block address to be written. The
>> caller is responsible for writing to only legitimate
>> locations.
>> - @param[in, out] Token A pointer to the token associated with the transaction.
>> + @param[in,out] Token A pointer to the token associated with the transaction.
>> @param[in] BufferSize Size of Buffer, must be a multiple of device block size.
>> @param[in] Buffer A pointer to the source buffer for the data.
>>
>> diff --git a/MdePkg/Include/Protocol/BlockIoCrypto.h b/MdePkg/Include/Protocol/BlockIoCrypto.h
>> index bcc0ed40beff..f15cde32f61b 100644
>> --- a/MdePkg/Include/Protocol/BlockIoCrypto.h
>> +++ b/MdePkg/Include/Protocol/BlockIoCrypto.h
>> @@ -356,7 +356,7 @@ EFI_STATUS
>> @param[in] MediaId The media ID that the read request is for.
>> @param[in] LBA The starting logical block address to read from on
>> the device.
>> - @param[in, out] Token A pointer to the token associated with the transaction.
>> + @param[in,out] Token A pointer to the token associated with the transaction.
>> @param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
>> of the intrinsic block size of the device.
>> @param[out] Buffer A pointer to the destination buffer for the data. The
>> @@ -423,7 +423,7 @@ EFI_STATUS
>> @param[in] MediaId The media ID that the read request is for.
>> @param[in] LBA The starting logical block address to read from on
>> the device.
>> - @param[in, out] Token A pointer to the token associated with the transaction.
>> + @param[in,out] Token A pointer to the token associated with the transaction.
>> @param[in] BufferSize The size of the Buffer in bytes. This must be a multiple
>> of the intrinsic block size of the device.
>> @param[in] Buffer A pointer to the source buffer for the data.
>> @@ -482,7 +482,7 @@ EFI_STATUS
>> will not be signaled.
>>
>> @param[in] This Pointer to the EFI_BLOCK_IO_CRYPTO_PROTOCOL instance.
>> - @param[in, out] Token A pointer to the token associated with the transaction.
>> + @param[in,out] Token A pointer to the token associated with the transaction.
>>
>> @retval EFI_SUCCESS The flush request was queued if Event is not NULL. All
>> outstanding data was written correctly to the device if
>> diff --git a/MdePkg/Include/Protocol/BluetoothHc.h b/MdePkg/Include/Protocol/BluetoothHc.h
>> index d75cb08f8928..29faf36fb7b7 100644
>> --- a/MdePkg/Include/Protocol/BluetoothHc.h
>> +++ b/MdePkg/Include/Protocol/BluetoothHc.h
>> @@ -164,7 +164,7 @@ EFI_STATUS
>> capability.
>>
>> @param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
>> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
>> specified by Buffer. On output, indicates the amount of
>> data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data that will be transmitted to
>> @@ -200,7 +200,7 @@ EFI_STATUS
>> ACL data packet, including Handle, PB flag, BC flag, data length, and data.
>>
>> @param[in] This Pointer to the EFI_BLUETOOTH_HC_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer
>> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer
>> specified by Buffer. On output, indicates the amount of
>> data actually transferred.
>> @param[out] Buffer A pointer to the buffer of data that will be received from
>> diff --git a/MdePkg/Include/Protocol/BluetoothIo.h b/MdePkg/Include/Protocol/BluetoothIo.h
>> index 620bfbc961cc..b4f6aee73e55 100644
>> --- a/MdePkg/Include/Protocol/BluetoothIo.h
>> +++ b/MdePkg/Include/Protocol/BluetoothIo.h
>> @@ -105,7 +105,7 @@ EFI_STATUS
>> Send L2CAP message (including L2CAP header).
>>
>> @param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
>> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
>> On output, indicates the amount of data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP
>> layer.
>> @param[in] Timeout Indicating the transfer should be completed within this time frame. The units are
>> in
>> @@ -212,7 +212,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_BLUETOOTH_IO_PROTOCOL instance.
>> @param[in] Handle A handle created by EFI_BLUETOOTH_IO_PROTOCOL.L2CapConnect indicates which
>> channel to send.
>> - @param[in, out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
>> + @param[in,out] BufferSize On input, indicates the size, in bytes, of the data buffer specified by Buffer.
>> On output, indicates the amount of data actually transferred.
>> @param[in] Buffer A pointer to the buffer of data that will be transmitted to Bluetooth L2CAP
>> layer.
>> @param[in] Timeout Indicating the transfer should be completed within this time frame. The units are
>> in
>> diff --git a/MdePkg/Include/Protocol/BluetoothLeConfig.h b/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> index 6331e60a8655..2ec8a48fc551 100644
>> --- a/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> +++ b/MdePkg/Include/Protocol/BluetoothLeConfig.h
>> @@ -234,9 +234,9 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
>> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
>> On output, indicates the amount of data actually returned.
>> - @param[in, out] Data A pointer to the buffer of data that will be returned.
>> + @param[in,out] Data A pointer to the buffer of data that will be returned.
>>
>> @retval EFI_SUCCESS The BluetoothLE configuration data is returned successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
>> @@ -293,9 +293,9 @@ EFI_STATUS
>> @param[in] This Pointer to the EFI_BLUETOOTH_LE_CONFIG_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> @param[in] BDAddr Remote BluetoothLE device address.
>> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
>> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified by Data.
>> On output, indicates the amount of data actually returned.
>> - @param[in, out] Data A pointer to the buffer of data that will be returned.
>> + @param[in,out] Data A pointer to the buffer of data that will be returned.
>>
>> @retval EFI_SUCCESS The remote BluetoothLE device configuration data is returned successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
>> @@ -464,7 +464,7 @@ typedef enum {
>> @param[in] BDAddr Remote BluetoothLE device address. For Local device setting, it
>> should be NULL.
>> @param[in] DataType Data type in EFI_BLUETOOTH_LE_SMP_DATA_TYPE.
>> - @param[in, out] DataSize On input, indicates the size, in bytes, of the data buffer specified
>> + @param[in,out] DataSize On input, indicates the size, in bytes, of the data buffer specified
>> by Data. On output, indicates the amount of data actually returned.
>> @param[out] Data A pointer to the buffer of data that will be returned.
>>
>> diff --git a/MdePkg/Include/Protocol/CcMeasurement.h b/MdePkg/Include/Protocol/CcMeasurement.h
>> index 4bf21fc42fa0..555356d56d66 100644
>> --- a/MdePkg/Include/Protocol/CcMeasurement.h
>> +++ b/MdePkg/Include/Protocol/CcMeasurement.h
>> @@ -139,7 +139,7 @@ typedef struct {
>> capability information and state information.
>>
>> @param[in] This Indicates the calling context
>> - @param[in, out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
>> + @param[in,out] ProtocolCapability The caller allocates memory for a EFI_CC_BOOT_SERVICE_CAPABILITY
>> structure and sets the size field to the size of the structure allocated.
>> The callee fills in the fields with the EFI CC BOOT Service capability
>> information and the current CC information.
>> diff --git a/MdePkg/Include/Protocol/CpuIo2.h b/MdePkg/Include/Protocol/CpuIo2.h
>> index 39ddda62bfcf..baddbeb51de5 100644
>> --- a/MdePkg/Include/Protocol/CpuIo2.h
>> +++ b/MdePkg/Include/Protocol/CpuIo2.h
>> @@ -81,7 +81,7 @@ typedef enum {
>> @param[in] Address The base address of the I/O operation.
>> @param[in] Count The number of I/O operations to perform. The number
>> of bytes moved is Width size * Count, starting at Address.
>> - @param[in, out] Buffer For read operations, the destination buffer to store the results.
>> + @param[in,out] Buffer For read operations, the destination buffer to store the results.
>> For write operations, the source buffer from which to write data.
>>
>> @retval EFI_SUCCESS The data was read from or written to the PI system.
>> diff --git a/MdePkg/Include/Protocol/Eap.h b/MdePkg/Include/Protocol/Eap.h
>> index 37b94b55c998..2c69772225ad 100644
>> --- a/MdePkg/Include/Protocol/Eap.h
>> +++ b/MdePkg/Include/Protocol/Eap.h
>> @@ -54,7 +54,7 @@ typedef VOID *EFI_PORT_HANDLE;
>> @param[in] RequestSize Packet size in bytes for the most recently received
>> EAP-Request packet.
>> @param[in] Buffer Pointer to the buffer to hold the built packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes.
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes.
>> On input, it is the buffer size provided by the caller.
>> On output, it is the buffer size in fact needed to contain
>> the packet.
>> diff --git a/MdePkg/Include/Protocol/EapConfiguration.h b/MdePkg/Include/Protocol/EapConfiguration.h
>> index 6fcddabcb7b2..4bd100677b55 100644
>> --- a/MdePkg/Include/Protocol/EapConfiguration.h
>> +++ b/MdePkg/Include/Protocol/EapConfiguration.h
>> @@ -114,8 +114,8 @@ EFI_STATUS
>> @param[in] This Pointer to the EFI_EAP_CONFIGURATION_PROTOCOL instance.
>> @param[in] EapType EAP type.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] Data Pointer to configuration data.
>> - @param[in, out] DataSize Total size of configuration data. On input, it means
>> + @param[in,out] Data Pointer to configuration data.
>> + @param[in,out] DataSize Total size of configuration data. On input, it means
>> the size of Data buffer. On output, it means the size
>> of copied Data buffer if EFI_SUCCESS, and means the
>> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
>> diff --git a/MdePkg/Include/Protocol/EapManagement.h b/MdePkg/Include/Protocol/EapManagement.h
>> index ea1b0d71e357..20f915e30cf5 100644
>> --- a/MdePkg/Include/Protocol/EapManagement.h
>> +++ b/MdePkg/Include/Protocol/EapManagement.h
>> @@ -294,7 +294,7 @@ EFI_STATUS
>> instance that indicates the calling context.
>> @param[out] CurrentState Returns the current state of the Supplicant PAE
>> state machine for the Port.
>> - @param[in, out] Configuration Returns the configuration of the operational
>> + @param[in,out] Configuration Returns the configuration of the operational
>> parameters of the Supplicant PAE state machine
>> for the Port as required. This parameter can be
>> NULL to ignore reading the configuration.
>> diff --git a/MdePkg/Include/Protocol/EapManagement2.h b/MdePkg/Include/Protocol/EapManagement2.h
>> index ab42b04e1a04..768f82b6aab2 100644
>> --- a/MdePkg/Include/Protocol/EapManagement2.h
>> +++ b/MdePkg/Include/Protocol/EapManagement2.h
>> @@ -33,10 +33,10 @@ typedef struct _EFI_EAP_MANAGEMENT2_PROTOCOL EFI_EAP_MANAGEMENT2_PROTOCOL;
>> MAC layer driver can use MSK to derive more keys, e.g. PMK (Pairwise Master Key).
>>
>> @param[in] This Pointer to the EFI_EAP_MANAGEMENT2_PROTOCOL instance.
>> - @param[in, out] Msk Pointer to MSK (Master Session Key) buffer.
>> - @param[in, out] MskSize MSK buffer size.
>> - @param[in, out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
>> - @param[in, out] EmskSize EMSK buffer size.
>> + @param[in,out] Msk Pointer to MSK (Master Session Key) buffer.
>> + @param[in,out] MskSize MSK buffer size.
>> + @param[in,out] Emsk Pointer to EMSK (Extended Master Session Key) buffer.
>> + @param[in,out] EmskSize EMSK buffer size.
>>
>> @retval EFI_SUCCESS The operation completed successfully.
>> @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE:
>> diff --git a/MdePkg/Include/Protocol/EraseBlock.h b/MdePkg/Include/Protocol/EraseBlock.h
>> index bfa5921400aa..5f71ccdf9a0e 100644
>> --- a/MdePkg/Include/Protocol/EraseBlock.h
>> +++ b/MdePkg/Include/Protocol/EraseBlock.h
>> @@ -45,7 +45,7 @@ typedef struct {
>> @param[in] LBA The starting logical block address to be
>> erased. The caller is responsible for erasing
>> only legitimate locations.
>> - @param[in, out] Token A pointer to the token associated with the
>> + @param[in,out] Token A pointer to the token associated with the
>> transaction.
>> @param[in] Size The size in bytes to be erased. This must be
>> a multiple of the physical block size of the
>> diff --git a/MdePkg/Include/Protocol/FirmwareManagement.h b/MdePkg/Include/Protocol/FirmwareManagement.h
>> index f37067df3455..3bdebc29accd 100644
>> --- a/MdePkg/Include/Protocol/FirmwareManagement.h
>> +++ b/MdePkg/Include/Protocol/FirmwareManagement.h
>> @@ -286,12 +286,12 @@ EFI_STATUS
>> The saved copy could later been used, for example, in firmware image recovery or rollback.
>>
>> @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance.
>> - @param[in, out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
>> + @param[in,out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer.
>> On input, this is the size of the buffer allocated by the caller.
>> On output, it is the size of the buffer returned by the firmware
>> if the buffer was large enough, or the size of the buffer needed
>> to contain the image(s) information if the buffer was too small.
>> - @param[in, out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
>> + @param[in,out] ImageInfo A pointer to the buffer in which firmware places the current image(s)
>> information. The information is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs.
>> @param[out] DescriptorVersion A pointer to the location in which firmware returns the version number
>> associated with the EFI_FIRMWARE_IMAGE_DESCRIPTOR.
>> @@ -340,7 +340,7 @@ EFI_STATUS
>> @param[in] ImageIndex A unique number identifying the firmware image(s) within the device.
>> The number is between 1 and DescriptorCount.
>> @param[out] Image Points to the buffer where the current image is copied to.
>> - @param[in, out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
>> + @param[in,out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes.
>> On return, points to the length of the image, in bytes.
>>
>> @retval EFI_SUCCESS The device was successfully updated with the new image.
>> diff --git a/MdePkg/Include/Protocol/I2cEnumerate.h b/MdePkg/Include/Protocol/I2cEnumerate.h
>> index e1890e470c62..be07979043ae 100644
>> --- a/MdePkg/Include/Protocol/I2cEnumerate.h
>> +++ b/MdePkg/Include/Protocol/I2cEnumerate.h
>> @@ -28,7 +28,7 @@ typedef struct _EFI_I2C_ENUMERATE_PROTOCOL EFI_I2C_ENUMERATE_PROTOCOL;
>>
>> @param[in] This The platform data for the next device on
>> the I2C bus was returned successfully.
>> - @param[in, out] Device Pointer to a buffer containing an
>> + @param[in,out] Device Pointer to a buffer containing an
>> EFI_I2C_DEVICE structure. Enumeration is
>> started by setting the initial EFI_I2C_DEVICE
>> structure pointer to NULL. The buffer
>> diff --git a/MdePkg/Include/Protocol/IpSec.h b/MdePkg/Include/Protocol/IpSec.h
>> index 0b5d55a85293..6295bf43d401 100644
>> --- a/MdePkg/Include/Protocol/IpSec.h
>> +++ b/MdePkg/Include/Protocol/IpSec.h
>> @@ -55,11 +55,11 @@ typedef struct _EFI_IPSEC_FRAGMENT_DATA {
>> @param[in] This Pointer to the EFI_IPSEC_PROTOCOL instance.
>> @param[in] NicHandle Instance of the network interface.
>> @param[in] IpVer IPV4 or IPV6.
>> - @param[in, out] IpHead Pointer to the IP Header.
>> + @param[in,out] IpHead Pointer to the IP Header.
>> @param[in] LastHead The protocol of the next layer to be processed by IPsec.
>> @param[in] OptionsBuffer Pointer to the options buffer.
>> @param[in] OptionsLength Length of the options buffer.
>> - @param[in, out] FragmentTable Pointer to a list of fragments.
>> + @param[in,out] FragmentTable Pointer to a list of fragments.
>> @param[in] FragmentCount Number of fragments.
>> @param[in] TrafficDirection Traffic direction.
>> @param[out] RecycleSignal Event for recycling of resources.
>> @@ -111,7 +111,7 @@ struct _EFI_IPSEC_PROTOCOL {
>> @param[in] This Pointer to the EFI_IPSEC2_PROTOCOL instance.
>> @param[in] NicHandle Instance of the network interface.
>> @param[in] IpVer IP version.IPv4 or IPv6.
>> - @param[in, out] IpHead Pointer to the IP Header it is either
>> + @param[in,out] IpHead Pointer to the IP Header it is either
>> the EFI_IP4_HEADER or EFI_IP6_HEADER.
>> On input, it contains the IP header.
>> On output, 1) in tunnel mode and the
>> @@ -123,10 +123,10 @@ struct _EFI_IPSEC_PROTOCOL {
>> mode, the related fielders (like payload
>> length, Next header) in IP header will
>> be modified according to the condition.
>> - @param[in, out] LastHead For IP4, it is the next protocol in IP
>> + @param[in,out] LastHead For IP4, it is the next protocol in IP
>> header. For IP6 it is the Next Header
>> of the last extension header.
>> - @param[in, out] OptionsBuffer On input, it contains the options
>> + @param[in,out] OptionsBuffer On input, it contains the options
>> (extensions header) to be processed by
>> IPsec. On output, 1) in tunnel mode and
>> the traffic direction is outbound, it
>> @@ -143,10 +143,10 @@ struct _EFI_IPSEC_PROTOCOL {
>> might be same with input's. The caller
>> should take the responsibility to free
>> the buffer both on input and on output.
>> - @param[in, out] OptionsLength On input, the input length of the options
>> + @param[in,out] OptionsLength On input, the input length of the options
>> buffer. On output, the output length of
>> the options buffer.
>> - @param[in, out] FragmentTable Pointer to a list of fragments. On input,
>> + @param[in,out] FragmentTable Pointer to a list of fragments. On input,
>> these fragments contain the IP payload.
>> On output, 1) in tunnel mode and the traffic
>> direction is inbound, the fragments contain
>> @@ -167,7 +167,7 @@ struct _EFI_IPSEC_PROTOCOL {
>> payload which encapsulates the next layer
>> protocol information between the encapsulated
>> header and encapsulated trailer fields.
>> - @param[in, out] FragmentCount Number of fragments.
>> + @param[in,out] FragmentCount Number of fragments.
>> @param[in] TrafficDirection Traffic direction.
>> @param[out] RecycleSignal Event for recycling of resources.
>>
>> diff --git a/MdePkg/Include/Protocol/IpSecConfig.h b/MdePkg/Include/Protocol/IpSecConfig.h
>> index 7136060691ca..2c9d3d8ddd45 100644
>> --- a/MdePkg/Include/Protocol/IpSecConfig.h
>> +++ b/MdePkg/Include/Protocol/IpSecConfig.h
>> @@ -647,7 +647,7 @@ EFI_STATUS
>> @param[in] DataType The type of data to retrieve.
>> @param[in] Selector Pointer to an entry selector which is an identifier of the IPsec
>> configuration data entry.
>> - @param[in, out] DataSize On output the size of data returned in Data.
>> + @param[in,out] DataSize On output the size of data returned in Data.
>> @param[out] Data The buffer to return the contents of the IPsec configuration data.
>> The type of the data buffer is associated with the DataType.
>>
>> @@ -692,8 +692,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_IPSEC_CONFIG_PROTOCOL instance.
>> @param[in] DataType The type of IPsec configuration data to retrieve.
>> - @param[in, out] SelectorSize The size of the Selector buffer.
>> - @param[in, out] Selector On input, supplies the pointer to last Selector that was
>> + @param[in,out] SelectorSize The size of the Selector buffer.
>> + @param[in,out] Selector On input, supplies the pointer to last Selector that was
>> returned by GetNextSelector().
>> On output, returns one copy of the current entry Selector
>> of a given DataType.
>> diff --git a/MdePkg/Include/Protocol/Kms.h b/MdePkg/Include/Protocol/Kms.h
>> index c37fcbb65c63..b63e7d2cbd1b 100644
>> --- a/MdePkg/Include/Protocol/Kms.h
>> +++ b/MdePkg/Include/Protocol/Kms.h
>> @@ -366,7 +366,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -379,7 +379,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -419,11 +419,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> processed by this operation. On return, this number
>> will be updated with the number of key descriptors
>> successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the keys to be generated.
>> On input, the KeyIdentifierSize and the KeyIdentifier
>> may specify an identifier to be used for the key,
>> @@ -447,7 +447,7 @@ EFI_STATUS
>> type and must be freed by the caller when it is no longer
>> needed. Also, the KeyStatus field must reflect the result
>> of the request relative to that key.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -460,7 +460,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -514,11 +514,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> processed by this operation. On return, this number
>> will be updated with the number of key descriptors
>> successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the keys to be retrieved
>> from the KMS.
>> On input, the KeyIdentifierSize and the KeyIdentifier
>> @@ -533,7 +533,7 @@ EFI_STATUS
>> must be freed by the caller when it is no longer needed.
>> Also, the KeyStatus field will reflect the result of the
>> request relative to the individual key descriptor.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -546,7 +546,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -602,11 +602,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> processed by this operation. On normal return, this
>> number will be updated with the number of key
>> descriptors successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the keys to be added.
>> On input, the KeyId field for first key must contain
>> valid identifier data to be used for adding a key to
>> @@ -619,7 +619,7 @@ EFI_STATUS
>> consistent values to be associated with the given KeyId.
>> On return, the KeyStatus field will reflect the result
>> of the operation for each key request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -632,7 +632,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -688,11 +688,11 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors to be
>> processed by this operation. On normal return, this
>> number will be updated with the number of key
>> descriptors successfully processed.
>> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the keys to be deleted.
>> On input, the KeyId field for first key must contain
>> valid identifier data to be used for adding a key to
>> @@ -704,7 +704,7 @@ EFI_STATUS
>> KeyValue fields are ignored, but should be 0.
>> On return, the KeyStatus field will reflect the result
>> of the operation for each key request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -717,7 +717,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -770,19 +770,19 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> structures associated with the Key identifier. If none
>> are found, the count value is zero on return.
>> On input this value reflects the number of KeyAttributes
>> that may be returned.
>> On output, the value reflects the number of completed
>> KeyAttributes structures found.
>> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> structures associated with the Key Identifier.
>> On input, the fields in the structure should be NULL.
>> On output, the attribute fields will have updated values
>> for attributes associated with this key identifier.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -795,7 +795,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -858,18 +858,18 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> structures to associate with the Key. On normal returns,
>> this number will be updated with the number of key
>> attributes successfully processed.
>> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> structures providing the attribute information to
>> associate with the key.
>> On input, the values for the fields in the structure
>> are completely filled in.
>> On return the KeyAttributeStatus field will reflect the
>> result of the operation for each key attribute request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -882,7 +882,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -948,19 +948,19 @@ EFI_STATUS
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> @param[in] KeyIdentifierSize Pointer to the size in bytes of the KeyIdentifier variable.
>> @param[in] KeyIdentifier Pointer to the key identifier associated with this key.
>> - @param[in, out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributesCount Pointer to the number of EFI_KMS_KEY_ATTRIBUTE
>> structures to associate with the Key.
>> On input, the count value is one or more.
>> On normal returns, this number will be updated with
>> the number of key attributes successfully processed.
>> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> structures providing the attribute information to
>> associate with the key.
>> On input, the values for the fields in the structure
>> are completely filled in.
>> On return the KeyAttributeStatus field will reflect the
>> result of the operation for each key attribute request.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -973,7 +973,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> @@ -1029,23 +1029,23 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_KMS_PROTOCOL instance.
>> @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure.
>> - @param[in, out] KeyAttributesCount Pointer to a count of the number of key attribute structures
>> + @param[in,out] KeyAttributesCount Pointer to a count of the number of key attribute structures
>> that must be matched for each returned key descriptor.
>> On input the count value is one or more.
>> On normal returns, this number will be updated with
>> the number of key attributes successfully processed.
>> - @param[in, out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> + @param[in,out] KeyAttributes Pointer to an array of EFI_KMS_KEY_ATTRIBUTE
>> structure to search for.
>> On input, the values for the fields in the structure are
>> completely filled in.
>> On return the KeyAttributeStatus field will reflect the
>> result of the operation for each key attribute request.
>> - @param[in, out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
>> + @param[in,out] KeyDescriptorCount Pointer to a count of the number of key descriptors matched
>> by this operation.
>> On entry, this number will be zero.
>> On return, this number will be updated to the number
>> of key descriptors successfully found.
>> - @param[in, out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> + @param[in,out] KeyDescriptors Pointer to an array of EFI_KMS_KEY_DESCRIPTOR
>> structures which describe the keys from the KMS
>> having the KeyAttribute(s) specified.
>> On input, this pointer will be NULL.
>> @@ -1057,7 +1057,7 @@ EFI_STATUS
>> caller when it is no longer needed. Also, the KeyStatus
>> field of each descriptor will reflect the result of the
>> request relative to that key descriptor.
>> - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> + @param[in,out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of
>> data specified by the ClientData parameter. This
>> parameter may be NULL, in which case the ClientData
>> parameter will be ignored and no data will be
>> @@ -1070,7 +1070,7 @@ EFI_STATUS
>> In all cases, the value upon return to the caller will
>> be the size of the data block returned to the caller,
>> which will be zero if no data is returned from the KMS.
>> - @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of
>> + @param[in,out] ClientData Pointer to a pointer to an arbitrary block of data of
>> *ClientDataSize that is to be passed directly to the
>> KMS if it supports the use of client data. This
>> parameter may be NULL if and only if the
>> diff --git a/MdePkg/Include/Protocol/MmCommunication2.h b/MdePkg/Include/Protocol/MmCommunication2.h
>> index 1b56320c7fff..86f74d9d2fa8 100644
>> --- a/MdePkg/Include/Protocol/MmCommunication2.h
>> +++ b/MdePkg/Include/Protocol/MmCommunication2.h
>> @@ -28,9 +28,9 @@ typedef struct _EFI_MM_COMMUNICATION2_PROTOCOL EFI_MM_COMMUNICATION2_PROTOCOL;
>> This function provides a service to send and receive messages from a registered UEFI service.
>>
>> @param[in] This The EFI_MM_COMMUNICATION_PROTOCOL instance.
>> - @param[in, out] CommBufferPhysical Physical address of the MM communication buffer
>> - @param[in, out] CommBufferVirtual Virtual address of the MM communication buffer
>> - @param[in, out] CommSize The size of the data buffer being passed in. On exit, the
>> + @param[in,out] CommBufferPhysical Physical address of the MM communication buffer
>> + @param[in,out] CommBufferVirtual Virtual address of the MM communication buffer
>> + @param[in,out] CommSize The size of the data buffer being passed in. On exit, the
>> size of data being returned. Zero if the handler does not
>> wish to reply with any data. This parameter is optional
>> and may be NULL.
>> diff --git a/MdePkg/Include/Protocol/MmSwDispatch.h b/MdePkg/Include/Protocol/MmSwDispatch.h
>> index e7810662ecdb..fdecac020e5e 100644
>> --- a/MdePkg/Include/Protocol/MmSwDispatch.h
>> +++ b/MdePkg/Include/Protocol/MmSwDispatch.h
>> @@ -62,7 +62,7 @@ typedef struct _EFI_MM_SW_DISPATCH_PROTOCOL EFI_MM_SW_DISPATCH_PROTOCOL;
>> @param[in] This Pointer to the EFI_MM_SW_DISPATCH_PROTOCOL instance.
>> @param[in] DispatchFunction Function to register for handler when the specified software
>> MMI is generated.
>> - @param[in, out] RegisterContext Pointer to the dispatch function's context.
>> + @param[in,out] RegisterContext Pointer to the dispatch function's context.
>> The caller fills this context in before calling
>> the register function to indicate to the register
>> function which Software MMI input value the
>> diff --git a/MdePkg/Include/Protocol/Mtftp6.h b/MdePkg/Include/Protocol/Mtftp6.h
>> index 4abf296c1c01..ce5a1409c943 100644
>> --- a/MdePkg/Include/Protocol/Mtftp6.h
>> +++ b/MdePkg/Include/Protocol/Mtftp6.h
>> @@ -368,7 +368,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_MTFTP6_PROTOCOL instance.
>> @param[in] Token The token provided in the EFI_MTFTP6_PROTOCOL.WriteFile() by the caller.
>> - @param[in, out] Length Indicates the length of the raw data wanted on input, and the
>> + @param[in,out] Length Indicates the length of the raw data wanted on input, and the
>> length the data available on output.
>> @param[out] Buffer Pointer to the buffer where the data is stored.
>>
>> diff --git a/MdePkg/Include/Protocol/Pcd.h b/MdePkg/Include/Protocol/Pcd.h
>> index 25f73cda1423..56c7f03e2c99 100644
>> --- a/MdePkg/Include/Protocol/Pcd.h
>> +++ b/MdePkg/Include/Protocol/Pcd.h
>> @@ -424,7 +424,7 @@ EFI_STATUS
>> If it is not, an error will be returned.
>>
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
>> + @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
>> On input, if the SizeOfValue is greater than the maximum size supported
>> for this TokenNumber then the output value of SizeOfValue will reflect
>> the maximum size supported for this TokenNumber.
>> @@ -582,7 +582,7 @@ EFI_STATUS
>>
>> @param[in] Guid The 128-bit unique value that designates the namespace from which to extract the
>> value.
>> @param[in] TokenNumber The PCD token number.
>> - @param[in, out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
>> + @param[in,out] SizeOfBuffer A pointer to the length of the value being set for the PCD token.
>> On input, if the SizeOfValue is greater than the maximum size supported
>> for this TokenNumber then the output value of SizeOfValue will reflect
>> the maximum size supported for this TokenNumber.
>> @@ -643,7 +643,7 @@ EFI_STATUS
>>
>> @param[in] CallBackGuid The PCD token GUID being set.
>> @param[in] CallBackToken The PCD token number being set.
>> - @param[in, out] TokenData A pointer to the token data being set.
>> + @param[in,out] TokenData A pointer to the token data being set.
>> @param[in] TokenDataSize The size, in bytes, of the data being set.
>>
>> @retval VOID
>> @@ -737,7 +737,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
>> from which the search will start. On output, it designates the next valid token
>> namespace on the platform. If *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned. If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/PiPcd.h b/MdePkg/Include/Protocol/PiPcd.h
>> index e26733b5d9db..63b198c63e0e 100644
>> --- a/MdePkg/Include/Protocol/PiPcd.h
>> +++ b/MdePkg/Include/Protocol/PiPcd.h
>> @@ -379,7 +379,7 @@ EFI_STATUS
>> Gets the next valid token namespace for a given namespace. This is useful to traverse the valid
>> token namespaces on a platform.
>>
>> - @param[in, out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
>> + @param[in,out] Guid An indirect pointer to EFI_GUID. On input it designates a known token namespace
>> from which the search will start. On output, it designates the next valid token
>> namespace on the platform. If *Guid is NULL, then the GUID of the first token
>> space of the current platform is returned. If the search cannot locate the next valid
>> diff --git a/MdePkg/Include/Protocol/S3SaveState.h b/MdePkg/Include/Protocol/S3SaveState.h
>> index c2b26944fb41..f9f45e0a115a 100644
>> --- a/MdePkg/Include/Protocol/S3SaveState.h
>> +++ b/MdePkg/Include/Protocol/S3SaveState.h
>> @@ -72,7 +72,7 @@ EFI_STATUS
>> in the boot script table specified by Position. If Position is NULL or points
>> to
>> NULL then the new opcode is inserted at the beginning of the table (if TRUE) or
>> end
>> of the table (if FALSE).
>> - @param[in, out] Position On entry, specifies the position in the boot script table where the opcode will
>> be
>> + @param[in,out] Position On entry, specifies the position in the boot script table where the opcode will
>> be
>> inserted, either before or after, depending on BeforeOrAfter. On exit,
>> specifies
>> the position of the inserted opcode in the boot script table.
>> @param[in] OpCode The operation code (opcode) number. See "Related Definitions" in Write() for
>> the
>> @@ -111,7 +111,7 @@ EFI_STATUS
>> NULL then the new label is inserted at the beginning of the table (if TRUE)
>> or end of
>> the table (if FALSE).
>> @param[in] CreateIfNotFound Specifies whether the label will be created if the label does not exists
>> (TRUE) or not (FALSE).
>> - @param[in, out] Position On entry, specifies the position in the boot script table where the label
>> will be inserted,
>> + @param[in,out] Position On entry, specifies the position in the boot script table where the label
>> will be inserted,
>> either before or after, depending on BeforeOrAfter. On exit, specifies the
>> position
>> of the inserted label in the boot script table.
>> @param[in] Label Points to the label which will be inserted in the boot script table.
>> diff --git a/MdePkg/Include/Protocol/Shell.h b/MdePkg/Include/Protocol/Shell.h
>> index 5efee49e197a..413dd0e4acbb 100644
>> --- a/MdePkg/Include/Protocol/Shell.h
>> +++ b/MdePkg/Include/Protocol/Shell.h
>> @@ -734,7 +734,7 @@ EFI_STATUS
>> If there are multiple map names they will be semi-colon seperated in the
>> NULL-terminated string.
>>
>> - @param[in, out] DevicePath On entry, points to a device path pointer. On
>> + @param[in,out] DevicePath On entry, points to a device path pointer. On
>> exit, updates the pointer to point to the
>> portion of the device path after the mapping.
>>
>> @@ -846,7 +846,7 @@ EFI_STATUS
>> @param[in] Path A pointer to the path string.
>> @param[in] OpenMode Specifies the mode used to open each file, EFI_FILE_MODE_READ or
>> EFI_FILE_MODE_WRITE.
>> - @param[in, out] FileList Points to the start of a list of files opened.
>> + @param[in,out] FileList Points to the start of a list of files opened.
>>
>> @retval EFI_SUCCESS Create the file list successfully.
>> @return Can't create the file list.
>> @@ -915,7 +915,7 @@ EFI_STATUS
>>
>> @param[in] FileHandle The opened file handle for read.
>> @param[in] ReadSize On input, the size of Buffer, in bytes. On output, the amount of data read.
>> - @param[in, out] Buffer The buffer in which data is read.
>> + @param[in,out] Buffer The buffer in which data is read.
>>
>> @retval EFI_SUCCESS Data was read.
>> @retval EFI_NO_MEDIA The device has no media.
>> @@ -1157,7 +1157,7 @@ EFI_STATUS
>> Direct writes to opened directories are not supported.
>>
>> @param[in] FileHandle The opened file handle for writing.
>> - @param[in, out] BufferSize On input, size of Buffer.
>> + @param[in,out] BufferSize On input, size of Buffer.
>> @param[in] Buffer The buffer in which data to write.
>>
>> @retval EFI_SUCCESS Data was written.
>> diff --git a/MdePkg/Include/Protocol/SmartCardEdge.h b/MdePkg/Include/Protocol/SmartCardEdge.h
>> index 1251680ec02f..2cf639a32633 100644
>> --- a/MdePkg/Include/Protocol/SmartCardEdge.h
>> +++ b/MdePkg/Include/Protocol/SmartCardEdge.h
>> @@ -225,13 +225,13 @@ extern EFI_GUID gEfiPaddingRsaesOaepGuid;
>>
>> @param[in] This Indicates a pointer to the calling context.
>> @param[out] NumberAidSupported Number of AIDs this protocol supports.
>> - @param[in, out] AidTableSize On input, number of items allocated for the
>> + @param[in,out] AidTableSize On input, number of items allocated for the
>> AID table. On output, number of items returned
>> by protocol.
>> @param[out] AidTable Table of the AIDs supported by the protocol.
>> @param[out] NumberSCPresent Number of currently present Smart Cards that
>> are supported by protocol.
>> - @param[in, out] CsnTableSize On input, the number of items the buffer CSN
>> + @param[in,out] CsnTableSize On input, the number of items the buffer CSN
>> table can contain. On output, the number of
>> items returned by the protocol.
>> @param[out] CsnTable Table of the CSN of the Smart Card present and
>> @@ -343,7 +343,7 @@ EFI_STATUS
>>
>> @param[in] This Indicates a pointer to the calling context.
>> @param[in] SCardHandle Handle on Smart Card connection.
>> - @param[in, out] ReaderNameLength On input, a pointer to the variable that holds
>> + @param[in,out] ReaderNameLength On input, a pointer to the variable that holds
>> the maximal size, in bytes, of ReaderName.
>> On output, the required size, in bytes, for ReaderName.
>> @param[out] ReaderName A pointer to a NULL terminated string that will
>> @@ -455,7 +455,7 @@ EFI_STATUS
>> @param[in] This Indicates a pointer to the calling context.
>> @param[in] SCardHandle Handle on Smart Card connection.
>> @param[in] DataId The type identifier of the data to get.
>> - @param[in, out] DataSize On input, in bytes, the size of Data. On output,
>> + @param[in,out] DataSize On input, in bytes, the size of Data. On output,
>> in bytes, the size of buffer required to store
>> the specified data.
>> @param[out] Data The data buffer in which the data is returned.
>> @@ -507,7 +507,7 @@ EFI_STATUS
>>
>> @param[in] This Indicates a pointer to the calling context.
>> @param[in] SCardHandle Handle on Smart Card connection.
>> - @param[in, out] CredentialSize On input, in bytes, the size of buffer to store
>> + @param[in,out] CredentialSize On input, in bytes, the size of buffer to store
>> the list of credential.
>> On output, in bytes, the size of buffer required
>> to store the entire list of credentials.
>> @@ -623,7 +623,7 @@ EFI_STATUS
>> - EFI_PADDING_RSAES_OAEP_GUID
>> @param[in] EncryptedSize Size of data to decrypt.
>> @param[in] EncryptedData Data to decrypt
>> - @param[in, out] PlaintextSize On input, in bytes, the size of buffer to store
>> + @param[in,out] PlaintextSize On input, in bytes, the size of buffer to store
>> the decrypted data.
>> On output, in bytes, the size of buffer required
>> to store the decrypted data.
>> diff --git a/MdePkg/Include/Protocol/SmartCardReader.h b/MdePkg/Include/Protocol/SmartCardReader.h
>> index 0ce117c9c764..a65b40932ec5 100644
>> --- a/MdePkg/Include/Protocol/SmartCardReader.h
>> +++ b/MdePkg/Include/Protocol/SmartCardReader.h
>> @@ -135,13 +135,13 @@ EFI_STATUS
>> @param[in] This Indicates a pointer to the calling context.
>> @param[out] ReaderName A pointer to a NULL terminated string that will
>> contain the reader name.
>> - @param[in, out] ReaderNameLength On input, a pointer to the variablethat holds the
>> + @param[in,out] ReaderNameLength On input, a pointer to the variablethat holds the
>> maximal size, in bytes,of ReaderName.
>> On output, the required size, in bytes, for ReaderName.
>> @param[out] State Current state of the smart card reader.
>> @param[out] CardProtocol Current protocol used to communicate with the smart card.
>> @param[out] Atr A pointer to retrieve the ATR of the smart card.
>> - @param[in, out] AtrLength On input, a pointer to hold the maximum size, in bytes,
>> + @param[in,out] AtrLength On input, a pointer to hold the maximum size, in bytes,
>> of Atr(usually 33).
>> On output, the required size, inbytes, for the smart
>> card ATR.
>> @@ -184,7 +184,7 @@ EFI_STATUS
>> @param[in] CAPDULength Command APDU size, in bytes.
>> @param[out] RAPDU A pointer to a byte array that will contain the
>> Response APDU.
>> - @param[in, out] RAPDULength On input, the maximum size, inbytes, of the Response
>> + @param[in,out] RAPDULength On input, the maximum size, inbytes, of the Response
>> APDU.
>> On output, the size, in bytes, of the Response APDU.
>>
>> @@ -226,7 +226,7 @@ EFI_STATUS
>> @param[in] InBuffer A pointer to the input parameters.
>> @param[in] InBufferLength Size, in bytes, of input parameters.
>> @param[out] OutBuffer A pointer to the output parameters.
>> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to store output
>> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to store output
>> parameters.
>> On output, the size, in bytes, of output parameters.
>>
>> @@ -271,7 +271,7 @@ EFI_STATUS
>> @param[in] Attrib Identifier for the attribute to retrieve.
>> @param[out] OutBuffer A pointer to a buffer that will contain
>> attribute data.
>> - @param[in, out] OutBufferLength On input, maximal size, in bytes, to store
>> + @param[in,out] OutBufferLength On input, maximal size, in bytes, to store
>> attribute data.
>> On output, the size, in bytes, of attribute
>> data.
>> diff --git a/MdePkg/Include/Protocol/Smbios.h b/MdePkg/Include/Protocol/Smbios.h
>> index f9346aac7224..83e8065f6fa3 100644
>> --- a/MdePkg/Include/Protocol/Smbios.h
>> +++ b/MdePkg/Include/Protocol/Smbios.h
>> @@ -97,7 +97,7 @@ typedef struct _EFI_SMBIOS_PROTOCOL EFI_SMBIOS_PROTOCOL;
>>
>> @param[in] This The EFI_SMBIOS_PROTOCOL instance.
>> @param[in] ProducerHandle The handle of the controller or driver associated with the SMBIOS
>> information. NULL means no handle.
>> - @param[in, out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique
>> handle
>> + @param[in,out] SmbiosHandle On entry, the handle of the SMBIOS record to add. If FFFEh, then a unique
>> handle
>> will be assigned to the SMBIOS record. If the SMBIOS handle is already in
>> use,
>> EFI_ALREADY_STARTED is returned and the SMBIOS record is not updated.
>> @param[in] Record The data for the fixed portion of the SMBIOS record. The format of the
>> record is
>> @@ -168,7 +168,7 @@ EFI_STATUS
>> only the SMBIOS records that match the optional Type argument.
>>
>> @param[in] This The EFI_SMBIOS_PROTOCOL instance.
>> - @param[in, out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points
>> to the
>> + @param[in,out] SmbiosHandle On entry, points to the previous handle of the SMBIOS record. On exit, points
>> to the
>> next SMBIOS record handle. If it is FFFEh on entry, then the first SMBIOS
>> record
>> handle will be returned. If it returns FFFEh on exit, then there are no more
>> SMBIOS records.
>> @param[in] Type On entry, it points to the type of the next SMBIOS record to return. If NULL,
>> it
>> diff --git a/MdePkg/Include/Protocol/SmmSwDispatch2.h b/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> index d0db953f06b0..27e91b5fb80f 100644
>> --- a/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> +++ b/MdePkg/Include/Protocol/SmmSwDispatch2.h
>> @@ -60,7 +60,7 @@ typedef struct _EFI_SMM_SW_DISPATCH2_PROTOCOL EFI_SMM_SW_DISPATCH2_PROTOCOL;
>> @param[in] This Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
>> @param[in] DispatchFunction Function to register for handler when the specified software
>> SMI is generated.
>> - @param[in, out] RegisterContext Pointer to the dispatch function's context.
>> + @param[in,out] RegisterContext Pointer to the dispatch function's context.
>> The caller fills this context in before calling
>> the register function to indicate to the register
>> function which Software SMI input value the
>> diff --git a/MdePkg/Include/Protocol/SuperIo.h b/MdePkg/Include/Protocol/SuperIo.h
>> index 802615030c91..bc7655e27281 100644
>> --- a/MdePkg/Include/Protocol/SuperIo.h
>> +++ b/MdePkg/Include/Protocol/SuperIo.h
>> @@ -45,7 +45,7 @@ typedef struct _EFI_SIO_PROTOCOL EFI_SIO_PROTOCOL;
>> The Super I/O driver must track the current state of the Super I/O and enable the
>> configuration mode of Super I/O if necessary prior to register access.
>> @param[in] Register Register number.
>> - @param[in, out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to
>> be
>> + @param[in,out] Value If Write is TRUE, Value is a pointer to the buffer containing the byte of data to
>> be
>> written to the Super I/O register. If Write is FALSE, Value is a pointer to the
>> destination buffer for the byte of data to be read from the Super I/O register.
>>
>> diff --git a/MdePkg/Include/Protocol/Supplicant.h b/MdePkg/Include/Protocol/Supplicant.h
>> index d78622112583..0c44673482b5 100644
>> --- a/MdePkg/Include/Protocol/Supplicant.h
>> +++ b/MdePkg/Include/Protocol/Supplicant.h
>> @@ -311,7 +311,7 @@ typedef struct {
>> RequestBuffer is NULL.
>> @param[out] Buffer Pointer to the buffer to hold the built
>> packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On
>> input, it is the buffer size provided by the
>> caller. On output, it is the buffer size in
>> fact needed to contain the packet.
>> @@ -347,7 +347,7 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_SUPPLICANT_PROTOCOL
>> instance.
>> - @param[in, out] FragmentTable Pointer to a list of fragment. The caller
>> + @param[in,out] FragmentTable Pointer to a list of fragment. The caller
>> will take responsible to handle the original
>> FragmentTable while it may be reallocated in
>> Supplicant driver.
>> @@ -410,7 +410,7 @@ EFI_STATUS
>> @param[in] DataType The type of data.
>> @param[out] Data Pointer to the buffer to hold the data.
>> Ignored if DataSize is 0.
>> - @param[in, out] DataSize Pointer to the buffer size in bytes. On
>> + @param[in,out] DataSize Pointer to the buffer size in bytes. On
>> input, it is the buffer size provided by the
>> caller. On output, it is the buffer size in
>> fact needed to contain the packet.
>> diff --git a/MdePkg/Include/Protocol/Tcg2Protocol.h b/MdePkg/Include/Protocol/Tcg2Protocol.h
>> index f1326a5ef022..7199b6407666 100644
>> --- a/MdePkg/Include/Protocol/Tcg2Protocol.h
>> +++ b/MdePkg/Include/Protocol/Tcg2Protocol.h
>> @@ -143,7 +143,7 @@ typedef struct tdEFI_TCG2_EVENT {
>> capability information and state information.
>>
>> @param[in] This Indicates the calling context
>> - @param[in, out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
>> + @param[in,out] ProtocolCapability The caller allocates memory for a EFI_TCG2_BOOT_SERVICE_CAPABILITY
>> structure and sets the size field to the size of the structure allocated.
>> The callee fills in the fields with the EFI protocol capability information
>> and the current EFI TCG2 state information up to the number of fields which
>> diff --git a/MdePkg/Include/Protocol/Tls.h b/MdePkg/Include/Protocol/Tls.h
>> index edcf0e3e728c..24c902530b44 100644
>> --- a/MdePkg/Include/Protocol/Tls.h
>> +++ b/MdePkg/Include/Protocol/Tls.h
>> @@ -376,8 +376,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
>> @param[in] DataType TLS session data type.
>> - @param[in, out] Data Pointer to session data.
>> - @param[in, out] DataSize Total size of session data. On input, it means
>> + @param[in,out] Data Pointer to session data.
>> + @param[in,out] DataSize Total size of session data. On input, it means
>> the size of Data buffer. On output, it means the size
>> of copied Data buffer if EFI_SUCCESS, and means the
>> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
>> @@ -422,7 +422,7 @@ EFI_STATUS
>> @param[in] RequestSize Packet size in bytes for the most recently received TLS
>> packet. 0 is only valid when RequestBuffer is NULL.
>> @param[out] Buffer Pointer to the buffer to hold the built packet.
>> - @param[in, out] BufferSize Pointer to the buffer size in bytes. On input, it is
>> + @param[in,out] BufferSize Pointer to the buffer size in bytes. On input, it is
>> the buffer size provided by the caller. On output, it
>> is the buffer size in fact needed to contain the
>> packet.
>> @@ -456,7 +456,7 @@ EFI_STATUS
>> The ProcessPacket () function process each inbound or outbound TLS APP packet.
>>
>> @param[in] This Pointer to the EFI_TLS_PROTOCOL instance.
>> - @param[in, out] FragmentTable Pointer to a list of fragment. The caller will take
>> + @param[in,out] FragmentTable Pointer to a list of fragment. The caller will take
>> responsible to handle the original FragmentTable while
>> it may be reallocated in TLS driver. If CryptMode is
>> EfiTlsEncrypt, on input these fragments contain the TLS
>> diff --git a/MdePkg/Include/Protocol/TlsConfig.h b/MdePkg/Include/Protocol/TlsConfig.h
>> index 8b2a94d41f8e..9b9019338757 100644
>> --- a/MdePkg/Include/Protocol/TlsConfig.h
>> +++ b/MdePkg/Include/Protocol/TlsConfig.h
>> @@ -87,8 +87,8 @@ EFI_STATUS
>>
>> @param[in] This Pointer to the EFI_TLS_CONFIGURATION_PROTOCOL instance.
>> @param[in] DataType Configuration data type.
>> - @param[in, out] Data Pointer to configuration data.
>> - @param[in, out] DataSize Total size of configuration data. On input, it means
>> + @param[in,out] Data Pointer to configuration data.
>> + @param[in,out] DataSize Total size of configuration data. On input, it means
>> the size of Data buffer. On output, it means the size
>> of copied Data buffer if EFI_SUCCESS, and means the
>> size of desired Data buffer if EFI_BUFFER_TOO_SMALL.
>> diff --git a/MdePkg/Include/Protocol/UfsDeviceConfig.h b/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> index 34676c7831c5..ae0253ae4f64 100644
>> --- a/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> +++ b/MdePkg/Include/Protocol/UfsDeviceConfig.h
>> @@ -34,8 +34,8 @@ typedef struct _EFI_UFS_DEVICE_CONFIG_PROTOCOL EFI_UFS_DEVICE_CONFIG_PROTOCOL;
>> @param[in] DescId The ID of device descriptor.
>> @param[in] Index The Index of device descriptor.
>> @param[in] Selector The Selector of device descriptor.
>> - @param[in, out] Descriptor The buffer of device descriptor to be read or written.
>> - @param[in, out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
>> + @param[in,out] Descriptor The buffer of device descriptor to be read or written.
>> + @param[in,out] DescSize The size of device descriptor buffer. On input, the size, in bytes,
>> of the data buffer specified by Descriptor. On output, the number
>> of bytes that were actually transferred.
>>
>> @@ -68,7 +68,7 @@ EFI_STATUS
>> @param[in] This The pointer to the EFI_UFS_DEVICE_CONFIG_PROTOCOL instance.
>> @param[in] Read The boolean variable to show r/w direction.
>> @param[in] FlagId The ID of flag to be read or written.
>> - @param[in, out] Flag The buffer to set or clear flag.
>> + @param[in,out] Flag The buffer to set or clear flag.
>>
>> @retval EFI_SUCCESS The flag descriptor is set/clear successfully.
>> @retval EFI_INVALID_PARAMETER This is NULL or Flag is NULL.
>> @@ -96,8 +96,8 @@ EFI_STATUS
>> @param[in] AttrId The ID of Attribute.
>> @param[in] Index The Index of Attribute.
>> @param[in] Selector The Selector of Attribute.
>> - @param[in, out] Attribute The buffer of Attribute to be read or written.
>> - @param[in, out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
>> + @param[in,out] Attribute The buffer of Attribute to be read or written.
>> + @param[in,out] AttrSize The size of Attribute buffer. On input, the size, in bytes, of the
>> data buffer specified by Attribute. On output, the number of bytes
>> that were actually transferred.
>>
>> diff --git a/MdePkg/Include/Protocol/UsbFunctionIo.h b/MdePkg/Include/Protocol/UsbFunctionIo.h
>> index e360b604808e..3b0fcba69806 100644
>> --- a/MdePkg/Include/Protocol/UsbFunctionIo.h
>> +++ b/MdePkg/Include/Protocol/UsbFunctionIo.h
>> @@ -343,7 +343,7 @@ EFI_STATUS
>> @param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
>> @param[in] EndpointIndex Indicates the endpoint.
>> @param[in] Direction Direction of the endpoint.
>> - @param[in, out] State Boolean, true value indicates that the endpoint
>> + @param[in,out] State Boolean, true value indicates that the endpoint
>> is in a stalled state, false otherwise.
>>
>> @retval EFI_SUCCESS The function returned successfully.
>> @@ -402,7 +402,7 @@ EFI_STATUS
>>
>> @param[in] This A pointer to the EFI_USBFN_IO_PROTOCOL instance.
>> @param[out] Message Indicates the event that initiated this notification.
>> - @param[in, out] PayloadSize On input, the size of the memory pointed by
>> + @param[in,out] PayloadSize On input, the size of the memory pointed by
>> Payload. On output, the amount ofdata returned
>> in Payload.
>> @param[out] Payload A pointer to EFI_USBFN_MESSAGE_PAYLOAD instance
>> @@ -446,14 +446,14 @@ EFI_STATUS
>> @param[in] EndpointIndex Indicates the endpoint on which TX or RX transfer
>> needs to take place.
>> @param[in] Direction Direction of the endpoint.
>> - @param[in, out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
>> + @param[in,out] BufferSize If Direction is EfiUsbEndpointDirectionDeviceRx:
>> On input, the size of the Bufferin bytes.
>> On output, the amount of data returned in Buffer
>> in bytes.
>> If Direction is EfiUsbEndpointDirectionDeviceTx:
>> On input, the size of the Bufferin bytes.
>> On output, the amount of data transmitted in bytes.
>> - @param[in, out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
>> + @param[in,out] Buffer If Direction is EfiUsbEndpointDirectionDeviceRx:
>> The Buffer to return the received data.
>> If Directionis EfiUsbEndpointDirectionDeviceTx:
>> The Buffer that contains the data to be transmitted.
>> @@ -630,9 +630,9 @@ EFI_STATUS
>> @param[in] Direction Direction of the endpoint.
>> @param[in] PolicyType Policy type the user is trying to retrieve for
>> the specified non-control endpoint.
>> - @param[in, out] BufferSize On input, the size of Bufferin bytes. On output,
>> + @param[in,out] BufferSize On input, the size of Bufferin bytes. On output,
>> the amount of data returned in Bufferin bytes.
>> - @param[in, out] Buffer A pointer to a buffer to return requested endpoint
>> + @param[in,out] Buffer A pointer to a buffer to return requested endpoint
>> policy value.
>>
>> @retval EFI_SUCCESS The function returned successfully.
>> diff --git a/MdePkg/Include/Protocol/UserCredential.h b/MdePkg/Include/Protocol/UserCredential.h
>> index 986cf44994f1..d1d957330493 100644
>> --- a/MdePkg/Include/Protocol/UserCredential.h
>> +++ b/MdePkg/Include/Protocol/UserCredential.h
>> @@ -83,10 +83,10 @@ EFI_STATUS
>> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
>>
>> @param[in] This Points to this instance of the EFI_USER_CREDENTIAL_PROTOCOL.
>> - @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
>> + @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
>> information will be returned. On exit, points to the width of the
>> bitmap returned.
>> - @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
>> + @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
>> information will be returned. On exit, points to the height of the
>> bitmap returned
>> @param[out] Hii On return, holds the HII database handle.
>> diff --git a/MdePkg/Include/Protocol/UserCredential2.h b/MdePkg/Include/Protocol/UserCredential2.h
>> index fc64ba544a2b..caec534d61ef 100644
>> --- a/MdePkg/Include/Protocol/UserCredential2.h
>> +++ b/MdePkg/Include/Protocol/UserCredential2.h
>> @@ -81,10 +81,10 @@ EFI_STATUS
>> by Width and Height. If no such bitmap exists, then EFI_NOT_FOUND is returned.
>>
>> @param[in] This Points to this instance of the EFI_USER_CREDENTIAL2_PROTOCOL.
>> - @param[in, out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
>> + @param[in,out] Width On entry, points to the desired bitmap width. If NULL then no bitmap
>> information will be returned. On exit, points to the width of the
>> bitmap returned.
>> - @param[in, out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
>> + @param[in,out] Height On entry, points to the desired bitmap height. If NULL then no bitmap
>> information will be returned. On exit, points to the height of the
>> bitmap returned
>> @param[out] Hii On return, holds the HII database handle.
>> diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h
>> index 7dfe35b4990b..516f4222d480 100644
>> --- a/MdePkg/Include/Uefi/UefiSpec.h
>> +++ b/MdePkg/Include/Uefi/UefiSpec.h
>> @@ -169,7 +169,7 @@ typedef struct {
>> 0x80000000..0xFFFFFFFF are reserved for use by UEFI OS loaders
>> that are provided by operating system vendors.
>> @param[in] Pages The number of contiguous 4 KB pages to allocate.
>> - @param[in, out] Memory The pointer to a physical address. On input, the way in which the address is
>> + @param[in,out] Memory The pointer to a physical address. On input, the way in which the address is
>> used depends on the value of Type.
>>
>> @retval EFI_SUCCESS The requested pages were allocated.
>> @@ -214,7 +214,7 @@ EFI_STATUS
>> /**
>> Returns the current memory map.
>>
>> - @param[in, out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
>> + @param[in,out] MemoryMapSize A pointer to the size, in bytes, of the MemoryMap buffer.
>> On input, this is the size of the buffer allocated by the caller.
>> On output, it is the size of the buffer returned by the firmware if
>> the buffer was large enough, or the size of the buffer needed to contain
>> @@ -391,7 +391,7 @@ EFI_STATUS
>> Determines the new virtual address that is to be used on subsequent memory accesses.
>>
>> @param[in] DebugDisposition Supplies type information for the pointer being converted.
>> - @param[in, out] Address A pointer to a pointer that is to be fixed to be the value needed
>> + @param[in,out] Address A pointer to a pointer that is to be fixed to be the value needed
>> for the new virtual address mappings being applied.
>>
>> @retval EFI_SUCCESS The pointer pointed to by Address was modified.
>> @@ -650,7 +650,7 @@ VOID
>> @param[in] VendorGuid A unique identifier for the vendor.
>> @param[out] Attributes If not NULL, a pointer to the memory location to return the
>> attributes bitmask for the variable.
>> - @param[in, out] DataSize On input, the size in bytes of the return Data buffer.
>> + @param[in,out] DataSize On input, the size in bytes of the return Data buffer.
>> On output the size of data returned in Data.
>> @param[out] Data The buffer to return the contents of the variable. May be NULL
>> with a zero DataSize in order to determine the size buffer needed.
>> @@ -679,12 +679,12 @@ EFI_STATUS
>> /**
>> Enumerates the current variable names.
>>
>> - @param[in, out] VariableNameSize The size of the VariableName buffer. The size must be large
>> + @param[in,out] VariableNameSize The size of the VariableName buffer. The size must be large
>> enough to fit input string supplied in VariableName buffer.
>> - @param[in, out] VariableName On input, supplies the last VariableName that was returned
>> + @param[in,out] VariableName On input, supplies the last VariableName that was returned
>> by GetNextVariableName(). On output, returns the Nullterminated
>> string of the current variable.
>> - @param[in, out] VendorGuid On input, supplies the last VendorGuid that was returned by
>> + @param[in,out] VendorGuid On input, supplies the last VendorGuid that was returned by
>> GetNextVariableName(). On output, returns the
>> VendorGuid of the current variable.
>>
>> @@ -1155,7 +1155,7 @@ typedef enum {
>> InstallMultipleProtocolInterfaces() be used in place of
>> InstallProtocolInterface()
>>
>> - @param[in, out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
>> + @param[in,out] Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
>> @param[in] Protocol The numeric ID of the protocol interface.
>> @param[in] InterfaceType Indicates whether Interface is supplied in native form.
>> @param[in] Interface A pointer to the protocol interface.
>> @@ -1180,7 +1180,7 @@ EFI_STATUS
>> /**
>> Installs one or more protocol interfaces into the boot services environment.
>>
>> - @param[in, out] Handle The pointer to a handle to install the new protocol interfaces on,
>> + @param[in,out] Handle The pointer to a handle to install the new protocol interfaces on,
>> or a pointer to NULL if a new handle is to be allocated.
>> @param ... A variable argument list containing pairs of protocol GUIDs and protocol
>> interfaces.
>> @@ -1479,7 +1479,7 @@ typedef enum {
>> @param[in] SearchType Specifies which handle(s) are to be returned.
>> @param[in] Protocol Specifies the protocol to search by.
>> @param[in] SearchKey Specifies the search key.
>> - @param[in, out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
>> + @param[in,out] BufferSize On input, the size in bytes of Buffer. On output, the size in bytes of
>> the array returned in Buffer (if the buffer was large enough) or the
>> size, in bytes, of the buffer needed to obtain the array (if the buffer was
>> not large enough).
>> @@ -1509,7 +1509,7 @@ EFI_STATUS
>> Locates the handle to a device on the device path that supports the specified protocol.
>>
>> @param[in] Protocol Specifies the protocol to search for.
>> - @param[in, out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
>> + @param[in,out] DevicePath On input, a pointer to a pointer to the device path. On output, the device
>> path pointer is modified to point to the remaining part of the device
>> path.
>> @param[out] Device A pointer to the returned device handle.
>> diff --git a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
>> b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
>> index e6f479b829f6..dfdee0b5d2c0 100644
>> --- a/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
>> +++ b/MdePkg/Library/BaseExtractGuidedSectionLib/BaseExtractGuidedSectionLib.c
>> @@ -28,7 +28,7 @@ typedef struct {
>> the registered guid and Handler list. When it is initialized, it will be directly returned.
>> Or, HandlerInfo table will be initialized in this function.
>>
>> - @param[in, out] InfoPointer The pointer to the handler information structure.
>> + @param[in,out] InfoPointer The pointer to the handler information structure.
>>
>> @retval RETURN_SUCCESS HandlerInfo table can be used to store guid and function tables.
>> @retval RETURN_OUT_OF_RESOURCES HandlerInfo table address is not writable.
>> diff --git a/MdePkg/Library/BaseLib/QuickSort.c b/MdePkg/Library/BaseLib/QuickSort.c
>> index d9f0e9a0f475..a7b7d0c6cd2b 100644
>> --- a/MdePkg/Library/BaseLib/QuickSort.c
>> +++ b/MdePkg/Library/BaseLib/QuickSort.c
>> @@ -22,7 +22,7 @@
>>
>> if Count is < 2 then perform no action.
>>
>> - @param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
>> + @param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
>> on return a buffer of sorted elements
>> @param[in] Count the number of elements in the buffer to sort
>> @param[in] ElementSize Size of an element in bytes
>> diff --git a/MdePkg/Library/BasePcdLibNull/PcdLib.c b/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> index a214371c3fdf..39303cf429a7 100644
>> --- a/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> +++ b/MdePkg/Library/BasePcdLibNull/PcdLib.c
>> @@ -470,7 +470,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -645,7 +645,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set a value from.
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -819,7 +819,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer that was set.
>> @@ -870,7 +870,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> @@ -923,7 +923,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -979,7 +979,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> index 417096f33493..63339fb4a627 100644
>> --- a/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> +++ b/MdePkg/Library/BasePeCoffLib/LoongArch/PeCoffLoaderEx.c
>> @@ -14,8 +14,8 @@
>> instruction sets.
>>
>> @param[in] Reloc Pointer to the relocation record.
>> - @param[in, out] Fixup Pointer to the address to fix up.
>> - @param[in, out] FixupData Pointer to a buffer to log the fixups.
>> + @param[in,out] Fixup Pointer to the address to fix up.
>> + @param[in,out] FixupData Pointer to a buffer to log the fixups.
>> @param[in] Adjust The offset to adjust the fixup.
>>
>> @return Status code.
>> @@ -117,8 +117,8 @@ PeCoffLoaderImageFormatSupported (
>> space for runtime calls.
>>
>> @param[in] Reloc The pointer to the relocation record.
>> - @param[in, out] Fixup The pointer to the address to fix up.
>> - @param[in, out] FixupData The pointer to a buffer to log the fixups.
>> + @param[in,out] Fixup The pointer to the address to fix up.
>> + @param[in,out] FixupData The pointer to a buffer to log the fixups.
>> @param[in] Adjust The offset to adjust the fixup.
>>
>> @return Status code.
>> diff --git a/MdePkg/Library/DxePcdLib/DxePcdLib.c b/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> index b2a8bf22a365..c371f26f24c1 100644
>> --- a/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> +++ b/MdePkg/Library/DxePcdLib/DxePcdLib.c
>> @@ -554,7 +554,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -731,7 +731,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set a value from.
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -926,7 +926,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -977,7 +977,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> @@ -1030,7 +1030,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -1086,7 +1086,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> index c538f157a242..2436e2c8f62e 100644
>> --- a/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> +++ b/MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.c
>> @@ -28,7 +28,7 @@ typedef struct {
>> Build guid hob for the global memory to store the registered guid and Handler list.
>> If GuidHob exists, HandlerInfo will be directly got from Guid hob data.
>>
>> - @param[in, out] InfoPointer The pointer to pei handler information structure.
>> + @param[in,out] InfoPointer The pointer to pei handler information structure.
>>
>> @retval RETURN_SUCCESS Build Guid hob for the global memory space to store guid and function tables.
>> @retval RETURN_OUT_OF_RESOURCES No enough memory to allocated.
>> diff --git a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> index 166d4a6f32d0..f16c1f8715a0 100644
>> --- a/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> +++ b/MdePkg/Library/PeiPcdLib/PeiPcdLib.c
>> @@ -544,7 +544,7 @@ LibPcdSet64S (
>> If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().
>>
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -721,7 +721,7 @@ LibPcdSetEx64S (
>> @param[in] Guid Pointer to a 128-bit unique value that
>> designates which namespace to set a value from.
>> @param[in] TokenNumber The PCD token number to set a current value for.
>> - @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer The size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to set.
>>
>> @return The status of the set operation.
>> @@ -918,7 +918,7 @@ LibPcdGetNextTokenSpace (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -969,7 +969,7 @@ LibPatchPcdSetPtr (
>> @param[out] PatchVariable A pointer to the global variable in a module that is
>> the target of the set operation.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> @@ -1022,7 +1022,7 @@ LibPatchPcdSetPtrS (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return Return the pointer to the buffer been set.
>> @@ -1078,7 +1078,7 @@ LibPatchPcdSetPtrAndSize (
>> the target of the set operation.
>> @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.
>> @param[in] MaximumDatumSize The maximum size allowed for the PCD entry specified by PatchVariable.
>> - @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> + @param[in,out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
>> @param[in] Buffer A pointer to the buffer to used to set the target variable.
>>
>> @return The status of the set operation.
>> diff --git a/MdePkg/Library/SmmIoLib/SmmIoLib.c b/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> index ad4bfff68c8a..070a0c4f7b2a 100644
>> --- a/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> +++ b/MdePkg/Library/SmmIoLib/SmmIoLib.c
>> @@ -155,9 +155,9 @@ SmmIsMmioValid (
>> /**
>> Merge continuous entries whose type is EfiGcdMemoryTypeMemoryMappedIo.
>>
>> - @param[in, out] GcdMemoryMap A pointer to the buffer in which firmware places
>> + @param[in,out] GcdMemoryMap A pointer to the buffer in which firmware places
>> the current GCD memory map.
>> - @param[in, out] NumberOfDescriptors A pointer to the number of the
>> + @param[in,out] NumberOfDescriptors A pointer to the number of the
>> GcdMemoryMap buffer. On input, this is the number of
>> the current GCD memory map. On output,
>> it is the number of new GCD memory map after merge.
>> diff --git a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> index ff143f00ab9a..1ba604b0cdda 100644
>> --- a/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> +++ b/MdePkg/Library/SmmPeriodicSmiLib/SmmPeriodicSmiLib.c
>> @@ -723,7 +723,7 @@ PeriodicSmiDispatchFunctionOnCpu (
>> released to notify the CPU that is running the SMM Foundation that the periodic
>> SMI handler execution has finished its execution.
>>
>> - @param[in, out] Buffer A pointer to the context for the periodic SMI handler.
>> + @param[in,out] Buffer A pointer to the context for the periodic SMI handler.
>>
>> **/
>> VOID
>> @@ -758,10 +758,10 @@ PeriodicSmiDispatchFunctionWithLock (
>> SmiHandlerRegister().
>> @param[in] Context Points to an optional handler context which was
>> specified when the handler was registered.
>> - @param[in, out] CommBuffer A pointer to a collection of data in memory that
>> + @param[in,out] CommBuffer A pointer to a collection of data in memory that
>> will be conveyed from a non-SMM environment into
>> an SMM environment.
>> - @param[in, out] CommBufferSize The size of the CommBuffer.
>> + @param[in,out] CommBufferSize The size of the CommBuffer.
>>
>> @retval EFI_SUCCESS The interrupt was handled and quiesced.
>> No other handlers should still be called.
>> @@ -863,7 +863,7 @@ PeriodicSmiDispatchFunction (
>> /**
>> This function enables a periodic SMI handler.
>>
>> - @param[in, out] DispatchHandle A pointer to the handle associated with the
>> + @param[in,out] DispatchHandle A pointer to the handle associated with the
>> enabled periodic SMI handler. This is an
>> optional parameter that may be NULL. If it is
>> NULL, then the handle will not be returned,
>> diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> index 86678e965d99..8fe52cab316f 100644
>> --- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> +++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
>> @@ -697,8 +697,8 @@ FileHandleSetSize (
>> if Destination's current length (including NULL terminator) is already more then
>> CurrentSize, then ASSERT()
>>
>> - @param[in, out] Destination The String to append onto
>> - @param[in, out] CurrentSize on call the number of bytes in Destination. On
>> + @param[in,out] Destination The String to append onto
>> + @param[in,out] CurrentSize on call the number of bytes in Destination. On
>> return possibly the new size (still in bytes). if NULL
>> then allocate whatever is needed.
>> @param[in] Source The String to append from
>> @@ -907,7 +907,7 @@ FileHandleGetFileName (
>> maintained and not changed for all operations with the same file.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
>> + @param[in,out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
>>
>> @return The line of text from the file.
>>
>> @@ -951,15 +951,15 @@ FileHandleReturnLine (
>> read a CHAR_NULL character will be returned in buffer.
>>
>> @param[in] Handle FileHandle to read from.
>> - @param[in, out] Buffer The pointer to buffer to read into.
>> - @param[in, out] Size The pointer to number of bytes in Buffer.
>> + @param[in,out] Buffer The pointer to buffer to read into.
>> + @param[in,out] Size The pointer to number of bytes in Buffer.
>> @param[in] Truncate If the buffer is large enough, this has no effect.
>> If the buffer is is too small and Truncate is TRUE,
>> the line will be truncated.
>> If the buffer is is too small and Truncate is FALSE,
>> then no read will occur.
>>
>> - @param[in, out] Ascii Boolean value for indicating whether the file is
>> + @param[in,out] Ascii Boolean value for indicating whether the file is
>> Ascii (TRUE) or UCS2 (FALSE).
>>
>> @retval EFI_SUCCESS The operation was successful. The line is stored in
>> diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> index a33cadd71646..af74ab732b21 100644
>> --- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> +++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
>> @@ -81,12 +81,12 @@ typedef struct {
>> is greater than zero, then this function will return
>> EFI_TIMEOUT if the time required to execute the SCSI
>> Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated by
>> + @param[in,out] SenseData A pointer to sense data that was generated by
>> the execution of the SCSI Request Packet. This
>> buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter is
>> optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, a pointer to the length in bytes of
>> + @param[in,out] SenseDataLength On input, a pointer to the length in bytes of
>> the SenseData buffer. On output, a pointer to
>> the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that produces
>> @@ -199,12 +199,12 @@ ScsiTestUnitReadyCommand (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI
>> @@ -218,12 +218,12 @@ ScsiTestUnitReadyCommand (
>> See the EFI SCSI I/O Protocol in the UEFI
>> Specification for details on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If InquiryDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
>> of the InquiryDataBuffer buffer.
>> On output, a pointer to the number of bytes
>> written to the InquiryDataBuffer buffer.
>> @@ -347,12 +347,12 @@ ScsiInquiryCommandEx (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI
>> @@ -366,12 +366,12 @@ ScsiInquiryCommandEx (
>> See the EFI SCSI I/O Protocol in the UEFI
>> Specification for details on the possible
>> return values.
>> - @param[in, out] InquiryDataBuffer A pointer to inquiry data that was generated
>> + @param[in,out] InquiryDataBuffer A pointer to inquiry data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If InquiryDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] InquiryDataLength On input, a pointer to the length in bytes
>> + @param[in,out] InquiryDataLength On input, a pointer to the length in bytes
>> of the InquiryDataBuffer buffer.
>> On output, a pointer to the number of bytes
>> written to the InquiryDataBuffer buffer.
>> @@ -464,12 +464,12 @@ ScsiInquiryCommand (
>> If Timeout is greater than zero, then this function
>> will return EFI_TIMEOUT if the time required to
>> execute the SCSI Request Packet is greater than Timeout.
>> - @param[in, out] SenseData A pointer to sense data that was generated
>> + @param[in,out] SenseData A pointer to sense data that was generated
>> by the execution of the SCSI Request Packet.
>> This buffer must be allocated by the caller.
>> If SenseDataLength is 0, then this parameter
>> is optional and may be NULL.
>> - @param[in, out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> + @param[in,out] SenseDataLength On input, the length in bytes of the SenseData buffer.
>> On output, the number of bytes written to the SenseData buffer.
>> @param[out] HostAdapterStatus The status of the SCSI Host Controller that
>> produces the SCSI bus containing the SCSI target
>> @@ -482,12 +482,12 @@ ScsiInquiryCommand (
>> on the SCSI Host Controller. See the EFI SCSI
>> I/O Protocol in the UEFI Specification for details
>> on the possible return values.
>> - @param[in, out] DataBuffer A pointer to data that was generated by the
>> + @param[in,out] DataBuffer A pointer to data that was generated by the
>> execution of the SCSI Request Packet. This
>> buffer must be allocated by the caller. If
>> DataLength is 0, then this parameter is optional
>> and may be NULL.
>> - @param[in, out] DataLength On input, a pointer to the length in bytes of
>> + @param[in,out] DataLength On input, a pointer to the length in bytes of
>> the DataBuffer buffer. On output, a pointer
>> to the number of bytes written to the DataBuffer
>> buffer.
>> @@ -602,8 +602,8 @@ ScsiModeSense10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>>
>> @@ -687,12 +687,12 @@ ScsiRequestSenseCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @@ -790,12 +790,12 @@ ScsiReadCapacityCommand (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] Pmi Partial medium indicator.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @@ -896,12 +896,12 @@ ScsiReadCapacity16Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 10 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 10 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -995,12 +995,12 @@ ScsiRead10Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -1095,12 +1095,12 @@ ScsiWrite10Command (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -1194,12 +1194,12 @@ ScsiRead16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks of data that shall be transferred.
>>
>> @@ -1293,8 +1293,8 @@ ScsiWrite16Command (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to use.
>> @@ -1302,7 +1302,7 @@ ScsiWrite16Command (
>> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL IN command.
>> @param[in] DataLength The size in bytes of the data buffer.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> @param[out] TransferLength A pointer to a buffer to store the size in
>> bytes of the data written to the data buffer.
>>
>> @@ -1408,8 +1408,8 @@ ScsiSecurityProtocolInCommand (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> @param[in] SecurityProtocol The Security Protocol to use.
>> @@ -1417,7 +1417,7 @@ ScsiSecurityProtocolInCommand (
>> @param[in] Inc512 If TRUE, 512 increment (INC_512) bit will be set for the
>> SECURITY PROTOCOL OUT command.
>> @param[in] DataLength The size in bytes of the transfer data.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>>
>> @retval EFI_SUCCESS Command is executed successfully.
>> @retval EFI_BAD_BUFFER_SIZE The SCSI Request Packet was executed, but the entire DataBuffer could
>> @@ -1573,12 +1573,12 @@ ScsiLibNotify (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -1756,12 +1756,12 @@ ScsiRead10CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -1939,12 +1939,12 @@ ScsiWrite10CommandEx (
>>
>> @param[in] ScsiIo A pointer to SCSI IO protocol.
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer Read 16 command data.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer Read 16 command data.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> @@ -2122,12 +2122,12 @@ ScsiRead16CommandEx (
>>
>> @param[in] ScsiIo SCSI IO Protocol to use
>> @param[in] Timeout The length of timeout period.
>> - @param[in, out] SenseData A pointer to output sense data.
>> - @param[in, out] SenseDataLength The length of output sense data.
>> + @param[in,out] SenseData A pointer to output sense data.
>> + @param[in,out] SenseDataLength The length of output sense data.
>> @param[out] HostAdapterStatus The status of Host Adapter.
>> @param[out] TargetStatus The status of the target.
>> - @param[in, out] DataBuffer A pointer to a data buffer.
>> - @param[in, out] DataLength The length of data buffer.
>> + @param[in,out] DataBuffer A pointer to a data buffer.
>> + @param[in,out] DataLength The length of data buffer.
>> @param[in] StartLba The start address of LBA.
>> @param[in] SectorSize The number of contiguous logical blocks
>> of data that shall be transferred.
>> --
>> 2.30.2
>>
>>
>>
>>
>>
>
>
>
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2023-03-14 21:00 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-02-20 18:45 [PATCH 1/1] MdePkg: Remove whitespace in doxygen param passing direction [in,out] Rebecca Cran
2023-02-21 1:58 ` [edk2-devel] " Tinh Nguyen
2023-02-21 2:03 ` Rebecca Cran
2023-03-10 3:03 ` 回复: " gaoliming
2023-03-14 18:06 ` Rebecca Cran
2023-03-14 20:38 ` Michael D Kinney
2023-03-14 21:00 ` Rebecca Cran
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox