scsi.h) (SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE 结构

  • 项目

SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE结构包含供应商特定的微代码 (，即固件) 映像，供机箱服务进程使用。

语法

typedef struct _SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE {
  UCHAR PageCode;
  UCHAR SubEnclosureId;
  UCHAR PageLength[2];
  UCHAR ExpectedGenerationCode[4];
  UCHAR Mode;
  UCHAR Reserved[2];
  UCHAR BufferID;
  UCHAR BufferOffset[4];
  UCHAR ImageLength[4];
  UCHAR DataLength[4];
  UCHAR Data[ANYSIZE_ARRAY];
} SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE, *PSES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE;

成员

PageCode

根据 值指定要发送或请求的诊断页。 对于微代码控制诊断页，值应0x0E。

SubEnclosureId

指定应用程序客户端向其发送微代码映像的子机箱。 如果该值与 SES_CONFIGURATION_DIAGNOSTIC_PAGE中找到的有效SUBENCLOSURE_IDENTIFIER字段值不匹配，则机箱服务进程应中止下载微代码操作，状态为0x80。

PageLength[2]

指定诊断页中后续的字节数。

ExpectedGenerationCode[4]

指定生成代码的预期值。 如果此参数未设置为当前代代码，则机箱服务进程将中止下载微代码操作，状态为0x80。

Mode

指定要使用哪种模式下载微代码。

值 含义
下载带偏移量的微代码，保存并激活
0x07
 在最后一个 SEND DIAGNOSTIC 命令将下载微代码控制诊断页传送到子克隆完成之后，机箱服务过程应验证完整的微代码图像 (例如，执行供应商特定的校验和) 并将新的微代码映像保存到非易失存储中。

如果微代码映像或保存操作中没有错误，则机箱服务进程应执行以下操作之一：
下载带有偏移量的微代码，保存并延迟激活
0x0E
 最后一个 SEND DIAGNOSTIC 命令将 SES_DOWNLOAD_MICROCODE_CONTROL_DIAGNOSTIC_PAGE 传送到子锁定器后，机箱服务过程应验证完整的微代码图像 (例如，执行供应商特定的校验和) ，将新的微代码映像保存到非易失性存储 (，例如闪存 ROM) ，并延迟激活新微码。

如果微代码映像或保存操作中没有错误，则机箱服务进程应将SES_DOWNLOAD_MICROCODE_STATUS_DESCRIPTOR中的“状态”字段设置为SES_DOWNLOAD_MICROCODE_STATUS_DIAGNOSTIC_PAGE中的0x13（如果请求），并在以下任一操作后激活新的微代码：

  • 在将 “模式 ”字段设置为“0x0F (即激活延迟微代码)
  • 开机
  • 硬重置
激活延迟的微代码
0x0F
 指定此模式的 SEND DIAGNOSTIC 命令完成后，机箱服务进程应激活延迟的微代码映像（如果有）。
Reserved
所有其他值
 留待将来使用。

Reserved[2]

留待将来使用。

BufferID

指定机箱服务进程内用于接收微代码图像的特定缓冲区。 机箱服务进程将供应商特定的缓冲区 ID 代码分配给缓冲区 (例如，main固件映像可以存储在缓冲区 00h 中，备份固件映像可以存储在缓冲区 01h) 中。 机箱服务进程应支持 00h 的缓冲区 ID 值。 如果支持多个缓冲区，则机箱服务进程应从 01h 开始连续分配其他缓冲区 ID 代码。 如果机箱服务进程收到不受支持的缓冲区 ID 代码，则应中止下载微代码操作，并将 SES_DOWNLOAD_MICROCODE_STATUS_DESCRIPTOR 中的“状态”字段设置为 SES_DOWNLOAD_MICROCODE_STATUS_DIAGNOSTIC_PAGE 结构中的0x80。

BufferOffset[4]

指定将微代码数据写入到的缓冲区内的偏移量（以字节为单位）。 机箱服务过程可能需要在连续的 SEND DIAGNOSTIC 命令中连续增加此字段。

ImageLength[4]

指定应用程序要发送到指定 BufferID 的微代码图像中的字节总数。

DataLength[4]

指定 数据的长度（以字节为单位）。

Data[ANYSIZE_ARRAY]

包含供应商特定的微代码映像的一部分。

要求

要求 值
最低受支持的客户端 适用于 Windows 10 版本 1709 及更高版本的 Windows。
标头 scsi.h (包括 Minitape.h、Storport.h)