public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "gaoliming via groups.io" <gaoliming=byosoft.com.cn@groups.io>
To: <devel@edk2.groups.io>, <qingyu.shang@intel.com>
Cc: "'Michael D Kinney'" <michael.d.kinney@intel.com>
Subject: 回复: [edk2-devel] [PATCH v4 2/3] MdeModulePkg: Update ReceiveData and SendData function description
Date: Wed, 06 Mar 2024 06:10:33 -0800	[thread overview]
Message-ID: <00f801da6fd0$0971e1f0$1c55a5d0$@byosoft.com.cn> (raw)
In-Reply-To: <6082ad3bafb377c7515e98ba0c5ff70acd236615.1708915895.git.qingyu.shang@intel.com>

Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>

> -----邮件原件-----
> 发件人: devel@edk2.groups.io <devel@edk2.groups.io> 代表 Qingyu
> 发送时间: 2024年2月26日 11:06
> 收件人: devel@edk2.groups.io
> 抄送: Liming Gao <gaoliming@byosoft.com.cn>; Michael D Kinney
> <michael.d.kinney@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 <gaoliming@byosoft.com.cn>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> Signed-off-by: Qingyu <qingyu.shang@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/7686176
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io]
-=-=-=-=-=-=-=-=-=-=-=-



  reply	other threads:[~2024-03-06 14:10 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-02-26  3:05 [edk2-devel] [PATCH v4 0/3] Update ReceiveData and SendData function description Qingyu
2024-02-26  3:05 ` [edk2-devel] [PATCH v4 1/3] MdePkg: " Qingyu
2024-03-06 14:10   ` 回复: " gaoliming via groups.io
2024-02-26  3:05 ` [edk2-devel] [PATCH v4 2/3] MdeModulePkg: " Qingyu
2024-03-06 14:10   ` gaoliming via groups.io [this message]
2024-02-26  3:05 ` [edk2-devel] [PATCH v4 3/3] SecurityPkg: " Qingyu
2024-02-28  5:57   ` Yao, Jiewen
2024-03-13  4:24 ` [edk2-devel] [PATCH v4 0/3] " Michael D Kinney

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-list from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='00f801da6fd0$0971e1f0$1c55a5d0$@byosoft.com.cn' \
    --to=devel@edk2.groups.io \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox