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