SRBEX_DATA_NVME_COMMAND結構 (srb.h)

SRBEX_DATA_NVME_COMMAND 結構可讓使用者以 NVMe 格式框架併發出命令。 此結構目前保留供系統使用。

語法

typedef struct _SRBEX_DATA_NVME_COMMAND {
  SRBEXDATATYPE Type;
  ULONG         Length;
  union {
    PVOID     ControllerHandle;
    ULONGLONG Reserved0;
  };
  union {
    struct {
      ULONG     CommandDWORD0;
      ULONG     CommandNSID;
      ULONG     Reserved1[2];
      ULONGLONG CommandMPTR;
      union {
        struct {
          ULONGLONG CommandPRP1;
          ULONGLONG CommandPRP2;
        };
        ULONGLONG CommandSGL1[2];
      };
      ULONG     CommandCDW10;
      ULONG     CommandCDW11;
      ULONG     CommandCDW12;
      ULONG     CommandCDW13;
      ULONG     CommandCDW14;
      ULONG     CommandCDW15;
    };
    struct {
      UCHAR  OPC;
      UCHAR  PSDT;
      USHORT CID;
      UCHAR  FCTYPE;
      UCHAR  Reserved[35];
      UCHAR  Specific[24];
    } FabricsCommand;
    struct {
      ULONG OPC : 8;
      ULONG FUSE : 2;
      ULONG Reserved : 4;
      ULONG PSDT : 2;
      ULONG CID : 16;
      UCHAR TypeSpecific[60];
    } Command;
  };
  UCHAR         CommandType;
  UCHAR         Reserved2;
  USHORT        CommandFlags;
  USHORT        ResponseFlags;
  union {
    struct {
      USHORT P : 1;
      USHORT SC : 8;
      USHORT SCT : 3;
      USHORT CRD : 2;
      USHORT M : 1;
      USHORT DNR : 1;
    } DUMMYSTRUCTNAME;
    USHORT AsUshort;
  } CommandStatus;
  ULONG         QID;
  ULONG         CommandTag;
  union {
    struct {
      ULONG CQEntryDW0;
      ULONG CQEntryDW1;
    };
    UCHAR Specific[8];
  };
  USHORT        SQHD;
  USHORT        SQID;
} SRBEX_DATA_NVME_COMMAND, *PSRBEX_DATA_NVME_COMMAND;

成員

Type

命令類型。 目前，這必須設定為 SrbExDataTypeNvmeCommand。

Length

這個結構的大小，以位元組為單位。

ControllerHandle

NVMe 控制器的迷你埠句柄。

Reserved0

保留;請勿使用。

CommandDWORD0

NVMe 命令內的命令 Dword 0 (請參閱 NVMe 規格) 。

CommandNSID

NVMe 命令內的命名空間識別碼 (請參閱 NVMe 規格) 。

Reserved1[2]

CommandMPTR

NVMe 命令內的元資料指標 (請參閱 NVMe 規格) 。

CommandPRP1

NVMe 命令內的實體區域頁面 (PRP) Entry 1， (請參閱 NVMe 規格) 。 若要指出PRP資訊存在，用戶必須設定SRBEX_DATA_NVME_COMMAND_FLAG的SRBEX_DATA_NVME_COMMAND_FLAG_PRP_SET_ALREADY旗標。

CommandPRP2

NVMe 命令內的 PRP 專案 2 (請參閱 NVMe 規格) 。 若要指出PRP資訊存在，用戶必須設定SRBEX_DATA_NVME_COMMAND_FLAG的SRBEX_DATA_NVME_COMMAND_FLAG_PRP_SET_ALREADY旗標。

CommandSGL1[2]

CommandCDW10

命令特定的 Dword 10 (請參閱 NVMe 規格) 。

CommandCDW11

命令特定的 Dword 11 (請參閱 NVMe 規格) 。

CommandCDW12

命令特定的 Dword 12 (請參閱 NVMe 規格) 。

CommandCDW13

命令特定的 Dword 13 (請參閱 NVMe 規格) 。

CommandCDW14

命令特定的 Dword 14 (請參閱 NVMe 規格) 。

CommandCDW15

命令特定的 Dword 15 (請參閱 NVMe 規格) 。

FabricsCommand

在 nvme.h 中NVMEOF_FABRICS_COMMAND

FabricsCommand.OPC

Opcode (7Fh) 。

FabricsCommand.PSDT

數據傳輸的 PRP 或 SGL。 (只使用位7：6，其餘部分會保留) 。

FabricsCommand.CID

網狀架構命令標識碼。

FabricsCommand.FCTYPE

網狀架構命令類型。

FabricsCommand.Reserved[35]

FabricsCommand.Specific[24]

Command

若要參考命令 DW0 (請參閱 NVMe 規格) 。

Command.OPC

Opcode (OPC) 。

Command.FUSE

Fused 作業 (FUSE) 。

Command.Reserved

保留;請勿使用。

Command.PSDT

數據傳輸的 PRP 或 SGL。

Command.CID

命令識別碼。

Command.TypeSpecific[60]

CommandType

指定 NVMe 命令類型的 SRBEX_DATA_NVME_COMMAND_TYPE 值。

Reserved2

保留;請勿使用。

CommandFlags

指定此 SRBEX 資料 NVMe 命令屬性 的SRBEX_DATA_NVME_COMMAND_FLAG 值。

ResponseFlags

定義於 SRBEX_DATA_NVME_RESPONSE_FLAG。

CommandStatus

[完成佇列] 專案的 [狀態] 字段 (請參閱 NVMe 規格) 。

CommandStatus.DUMMYSTRUCTNAME

內嵌結構。

CommandStatus.DUMMYSTRUCTNAME.P

P) 階段標籤 (。

CommandStatus.DUMMYSTRUCTNAME.SC

SC) (狀態代碼。

CommandStatus.DUMMYSTRUCTNAME.SCT

狀態代碼類型 (SCT) 。

CommandStatus.DUMMYSTRUCTNAME.CRD

命令重試延遲 (CRD) 。

CommandStatus.DUMMYSTRUCTNAME.M

(M) 。

CommandStatus.DUMMYSTRUCTNAME.DNR

請勿重試 DNR () 。

CommandStatus.AsUshort

QID

使用者指定的佇列標識碼 (請參閱 NVMe 規格) 。 如果未指定，請將此值設定為 0xFFFFFFFF。

CommandTag

命令標識碼的唯一使用者指定識別碼，以標示特定命令。 使用者可以使用 CommandTag 來追蹤 Windows (ETW 事件追蹤) 追蹤 (中命令的結果，例如 事件檢視器 記憶體記錄) 。

CQEntryDW0

完成佇列專案 DW0。

CQEntryDW1

完成佇列專案 DW1。

Specific[8]

SQHD

完成佇列專案中的 SQ 前端指標。

SQID

SQ 識別碼。

規格需求

另請參閱

• SRBEX_DATA_NVME_COMMAND_FLAG
• SRBEX_DATA_NVME_COMMAND_FLAG
• NVMe 規格