NVME_COMPLETION_ENTRY 構造体 (nvme.h)
完了キューのサイズが 16 バイトのエントリを指定します。
構文
typedef struct {
ULONG DW0;
ULONG DW1;
union {
struct {
USHORT SQHD;
USHORT SQID;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} DW2;
union {
struct {
USHORT CID;
NVME_COMMAND_STATUS Status;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} DW3;
} NVME_COMPLETION_ENTRY, *PNVME_COMPLETION_ENTRY;
メンバー
DW0
Dword 0 の内容には、コマンド固有の情報が含まれています。
コマンドで Dword 0 が使用されている場合、この Dword の定義は、関連付けられたコマンド定義内に含まれます。 コマンドで Dword 0 が使用されていない場合、このフィールドは予約されています。
DW1
DW2
Dword 2 の情報を含む共用体。
DW2.DUMMYSTRUCTNAME
DW2.DUMMYSTRUCTNAME.SQHD
SQ 識別子 (SQID) フィールドに示されている送信キューの現在の送信キュー ヘッド ポインターを示します。 これは、使用され、新しいエントリに再利用できる送信キュー エントリをホストに示すために使用されます。
注意
返される値は、完了キュー エントリが作成されたときの送信キュー ヘッド ポインターの値です。 ホスト ソフトウェアが完了キュー エントリを使用する時点までに、コントローラーには、示された値を超えて進んだ SQ Head ポインターが含まれる場合があります。
DW2.DUMMYSTRUCTNAME.SQID
関連付けられたコマンドが発行された送信キューを指定します。 SQID フィールドは、ホスト ソフトウェアによってコマンド識別子 (CID) と組み合わせて使用され、複数の送信キューが 1 つの完了キューを共有するときに完了したコマンドを一意に判断します。
DW2.AsUlong
DW3
Dword 3 の情報を含む共用体。
DW3.DUMMYSTRUCTNAME
DW3.DUMMYSTRUCTNAME.CID
完了しているコマンドの識別子を示します。
この識別子は、コマンドが送信キューに送信されるときにホスト ソフトウェアによって割り当てられます。 SQ 識別子 SQID とコマンド識別子 CID の組み合わせは、完了しているコマンドを一意に識別します。 一度に未処理の要求の最大数は 64,000 です。
DW3.DUMMYSTRUCTNAME.Status
完了しているコマンドの状態を示す NVME_COMMAND_STATUS 構造体。
このフィールドの 0h
値は、致命的または致命的でないエラー条件を含まない正常なコマンド完了を示します。 特に明記されていない限り、コマンドが複数の理由で正常に完了しなかった場合、返される特定の状態コードがベンダーによって選択されます。
DW3.AsUlong
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 |
Header | nvme.h |