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