NVME_COMMAND_EFFECTS_DATA union (nvme.h)
包含描述管理员或 I/O 命令的总体可能效果的信息,包括命令的任何可选功能。
此结构用于NVME_COMMAND_EFFECTS_LOG的 ACS 和 IOCS 字段。
语法
typedef union {
struct {
ULONG CSUPP : 1;
ULONG LBCC : 1;
ULONG NCC : 1;
ULONG NIC : 1;
ULONG CCC : 1;
ULONG Reserved0 : 11;
ULONG CSE : 3;
ULONG Reserved1 : 13;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} NVME_COMMAND_EFFECTS_DATA, *PNVME_COMMAND_EFFECTS_DATA;
成员
DUMMYSTRUCTNAME
DUMMYSTRUCTNAME.CSUPP
指示是否支持命令。
当此值设置为 1
时,控制器支持命令。 将此值清除为 0
时,控制器不支持命令,并且此结构中的所有其他字段都将清除为 0h
。
DUMMYSTRUCTNAME.LBCC
指示命令是否可以修改一个或多个命名空间中的逻辑块内容。
当此值设置为 1
时,命令可以修改一个或多个命名空间中的逻辑块内容。 将此值清除为 0
时,命令不会修改任何命名空间中的逻辑块内容。 逻辑块内容更改包括对逻辑块的写入。
DUMMYSTRUCTNAME.NCC
指示命令是否可以更改单个命名空间的功能。
当此值设置为 1
时,命令可以更改单个命名空间的功能。 将此值清除为 0
时,命令不会修改指定命名空间的任何命名空间功能。 命名空间功能更改包括逻辑格式更改。
DUMMYSTRUCTNAME.NIC
指示命令是否可以更改多个命名空间的命名空间数或功能。
当此值设置为 1
时,命令可以更改多个命名空间的命名空间数或功能。 将此值清除为 0
时,命令不会修改多个命名空间的命名空间数或功能。 命名空间清单更改 (NIC) 包括添加或删除命名空间。
DUMMYSTRUCTNAME.CCC
指示命令是否可以更改控制器功能。
当此值设置为 1
时,命令可以更改控制器功能。 将此值清除为 0
时,命令不会修改控制器功能。 控制器功能更改 (CCC) 包括一个固件更新,用于更改 CAP 寄存器中报告的功能。
DUMMYSTRUCTNAME.Reserved0
DUMMYSTRUCTNAME.CSE
一个NVME_COMMAND_EFFECT_SBUMISSION_EXECUTION_LIMITS值,用于定义关联命令的命令提交和执行建议。
DUMMYSTRUCTNAME.Reserved1
AsUlong
注解
在确定如何提交命令和命令完成后要执行的操作时,主机软件可能会考虑命令效果。 如果命令更改了特定功能。 命令完成后,主机软件应重新枚举和/或重新初始化关联的功能。
例如,如果命名空间功能发生更改,则主机软件应暂停使用关联的命名空间,提交可能导致命名空间功能更改的命令并等待其完成,然后重新发出“标识”命令。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
标头 | nvme.h |