NVME_CDW11_FEATURE_INTERRUPT_COALESCING union (nvme.h)

割り込みの結合設定を構成する割り込み結合機能のパラメーターが含まれます。

この構造体の値は、NVME_CDW11_FEATURES構造体の InterruptCoalescing フィールドで使用されます。

構文

typedef union {
  struct {
    ULONG THR : 8;
    ULONG TIME : 8;
    ULONG Reserved0 : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW11_FEATURE_INTERRUPT_COALESCING, *PNVME_CDW11_FEATURE_INTERRUPT_COALESCING;

メンバー

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.THR

ホストに割り込みを通知する前に、割り込みベクトルごとに集計するために推奨される完了キュー エントリの最小数を示します。 これは 0 に基づく値です。 この設定のリセット値は です 0h。

DUMMYSTRUCTNAME.TIME

コントローラーが割り込みの結合によって割り込みを遅延させる可能性がある、推奨される最大時間を 100 マイクロ秒単位で示します。 の 0h 値は、遅延なしに対応します。 コントローラーは、割り込みベクトルごと、またはすべての割り込みベクトルにこの時間を適用できます。 この設定のリセット値は です 0h。

DUMMYSTRUCTNAME.Reserved0

AsUlong

注釈

コントローラーは、集計時間 (TIME) または集計しきい値 (THR) の条件が満たされたときに割り込みを通知します。 TIME フィールドまたは THR フィールドのいずれかが に0hクリアされている場合、割り込み結合は暗黙的に無効になります。

割り込み結合機能は、コントローラーが Pin ベース、MSI、複数の MSI または MSI-X 割り込みに対して構成されている場合に有効です。 割り込みモードが変更された場合、コントローラーでこれらの設定を保持する必要はありません。 割り込みモードを変更した後、ホストはこの機能を再発行することをお勧めします。

コントローラーは、このベクトルに対して割り込みが既に処理されていることを検出すると、割り込みを遅延する可能性があります。 具体的には、特定の割り込みベクトルに関連付けられている 完了キュー ヘッド ドアベル レジスタが更新されている場合、コントローラーは完了キュー エントリが既に処理されていることを示します。 この場合、関連付けられているレジスタの書き込み時に、集計時間や集計しきい値をリセットまたは再起動できます。 これにより、集計時間または集計しきい値が 0 以外の特定のワークロードで割り込みが無期限に遅延する可能性があります。

割り込み結合機能は、I/O 送信キューと I/O 完了キューにのみ適用されます。 エラーで完了したコマンドの割り込みを結合しないでください。

要件

こちらもご覧ください

• NVME_CDW11_FEATURES