次の方法で共有


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;

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