Reviewed-by: Liming Gao <gaolim...@byosoft.com.cn> > -----邮件原件----- > 发件人: devel@edk2.groups.io <devel@edk2.groups.io> 代表 Qingyu > 发送时间: 2024年2月26日 11:06 > 收件人: devel@edk2.groups.io > 抄送: Liming Gao <gaolim...@byosoft.com.cn>; Michael D Kinney > <michael.d.kin...@intel.com> > 主题: [edk2-devel] [PATCH v4 2/3] MdeModulePkg: Update ReceiveData and > SendData function description > > AtaBusDxe, NvmExpressDxe, ScsiDiskDxe and EmmcDxe is used to back the > EFI_STORAGE_SECURITY_COMMAND_PROTOCOL, update the parameter > 'MediaId' > description for the protocal function ReceiveData and SendData as described > in Uefi spec 2.10 section 13.14. > > Cc: Liming Gao <gaolim...@byosoft.com.cn> > Cc: Michael D Kinney <michael.d.kin...@intel.com> > Signed-off-by: Qingyu <qingyu.sh...@intel.com> > --- > MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c | 8 > ++++++-- > MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.h | 8 > ++++++-- > .../Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.c | 8 ++++++-- > .../Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.h | 8 ++++++-- > MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 8 ++++++-- > MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h | 8 ++++++-- > MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.c | 12 > +++++++++--- > MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.h | 12 > +++++++++--- > 8 files changed, 54 insertions(+), 18 deletions(-) > > diff --git a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c > b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c > index a729c087ff5a..67c6389bb8b3 100644 > --- a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c > +++ b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.c > @@ -1483,7 +1483,9 @@ AtaDiskInfoWhichIde ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -1600,7 +1602,9 @@ AtaStorageSecurityReceiveData ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.h > b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.h > index 6bc345f7e777..8906947e28b3 100644 > --- a/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.h > +++ b/MdeModulePkg/Bus/Ata/AtaBusDxe/AtaBus.h > @@ -927,7 +927,9 @@ AtaDiskInfoWhichIde ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -1007,7 +1009,9 @@ AtaStorageSecurityReceiveData ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.c > b/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.c > index b6ed7f7031b3..e0a85c1cb34e 100644 > --- a/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.c > +++ b/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.c > @@ -1699,7 +1699,9 @@ TrustTransferNvmeDevice ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -1812,7 +1814,9 @@ NvmeStorageSecurityReceiveData ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.h > b/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.h > index 8cad15efd33a..5547e057e77a 100644 > --- a/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.h > +++ b/MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressBlockIo.h > @@ -289,7 +289,9 @@ NvmeBlockIoFlushBlocksEx ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -369,7 +371,9 @@ NvmeStorageSecurityReceiveData ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c > b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c > index 670f70caf41f..e79110c14e11 100644 > --- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c > +++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c > @@ -1897,7 +1897,9 @@ Done: > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -2119,7 +2121,9 @@ Done: > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h > b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h > index 5a25b55c4952..49a00403695f 100644 > --- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h > +++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h > @@ -677,7 +677,9 @@ ScsiDiskEraseBlocks ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -751,7 +753,9 @@ ScsiDiskReceiveData ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.c > b/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.c > index 39b7c7ce6ef1..61fa740be505 100644 > --- a/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.c > +++ b/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.c > @@ -1267,7 +1267,9 @@ EmmcFlushBlocksEx ( > function shall return EFI_DEVICE_ERROR. > > @param[in] This Indicates a pointer to > the calling context. > - @param[in] MediaId ID of the medium to > receive data from. > + @param[in] MediaId ID of the medium to > receive data from. If there is no > + block IO protocol > supported by the physical device, the > + value of MediaId is > undefined. > @param[in] Timeout The timeout, in 100ns > units, to use for the execution > of the security > protocol command. A Timeout value of 0 > means that this > function will wait indefinitely for the > @@ -1454,7 +1456,9 @@ EmmcSecurityProtocolInOut ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -1555,7 +1559,9 @@ EmmcSecurityProtocolIn ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > diff --git a/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.h > b/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.h > index 2568f0359df3..8c7e5d2675ff 100644 > --- a/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.h > +++ b/MdeModulePkg/Bus/Sd/EmmcDxe/EmmcBlockIo.h > @@ -250,7 +250,9 @@ EmmcFlushBlocksEx ( > function shall return EFI_DEVICE_ERROR. > > @param[in] This Indicates a pointer to > the calling context. > - @param[in] MediaId ID of the medium to > receive data from. > + @param[in] MediaId ID of the medium to > receive data from. If there is no > + block IO protocol > supported by the physical device, the > + value of MediaId is > undefined. > @param[in] Timeout The timeout, in 100ns > units, to use for the execution > of the security > protocol command. A Timeout value of 0 > means that this > function will wait indefinitely for the > @@ -337,7 +339,9 @@ EmmcSecurityProtocolInOut ( > function shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > @@ -417,7 +421,9 @@ EmmcSecurityProtocolIn ( > shall return EFI_DEVICE_ERROR. > > @param This Indicates a pointer to the > calling context. > - @param MediaId ID of the medium to > receive data from. > + @param MediaId ID of the medium to > receive data from. If there is no > + block IO protocol supported > by the physical device, the > + value of MediaId is > undefined. > @param Timeout The timeout, in 100ns units, > to use for the execution > of the security protocol > command. A Timeout value of 0 > means that this function > will wait indefinitely for the > -- > 2.39.1.windows.1 > > > > >
-=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#116441): https://edk2.groups.io/g/devel/message/116441 Mute This Topic: https://groups.io/mt/104766056/21656 Group Owner: devel+ow...@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [arch...@mail-archive.com] -=-=-=-=-=-=-=-=-=-=-=-