NVME_CDW11_FEATURES union (nvme.h)

  • [アーティクル]

指定したフィーチャの属性を取得または設定する [フィーチャの取得] コマンドと [機能の設定] コマンドのパラメーターが含まれます。

この構造体は、Command 構造体の GETFEATURES フィールドと SETFEATURES フィールドの CDW11 パラメーターで使用されます。

構文

typedef union {
  NVME_CDW11_FEATURE_NUMBER_OF_QUEUES              NumberOfQueues;
  NVME_CDW11_FEATURE_INTERRUPT_COALESCING          InterruptCoalescing;
  NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG       InterruptVectorConfig;
  NVME_CDW11_FEATURE_LBA_RANGE_TYPE                LbaRangeType;
  NVME_CDW11_FEATURE_ARBITRATION                   Arbitration;
  NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE          VolatileWriteCache;
  NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG            AsyncEventConfig;
  NVME_CDW11_FEATURE_POWER_MANAGEMENT              PowerManagement;
  NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION   AutoPowerStateTransition;
  NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD         TemperatureThreshold;
  NVME_CDW11_FEATURE_ERROR_RECOVERY                ErrorRecovery;
  NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER            HostMemoryBuffer;
  NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL        WriteAtomicityNormal;
  NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE   NonOperationalPowerState;
  NVME_CDW11_FEATURE_IO_COMMAND_SET_PROFILE        IoCommandSetProfile;
  NVME_CDW11_FEATURE_ERROR_INJECTION               ErrorInjection;
  NVME_CDW11_FEATURE_HOST_IDENTIFIER               HostIdentifier;
  NVME_CDW11_FEATURE_RESERVATION_PERSISTENCE       ReservationPersistence;
  NVME_CDW11_FEATURE_RESERVATION_NOTIFICATION_MASK ReservationNotificationMask;
  NVME_CDW11_FEATURE_GET_HOST_METADATA             GetHostMetadata;
  NVME_CDW11_FEATURE_SET_HOST_METADATA             SetHostMetadata;
  ULONG                                            AsUlong;
} NVME_CDW11_FEATURES, *PNVME_CDW11_FEATURES;

メンバー

NumberOfQueues

ホストがこの コントローラーに対 して要求するキューの数を示す値を含むNVME_CDW11_FEATURE_NUMBER_OF_QUEUES構造体を指定します。

[キューの数] 機能に対して [機能の設定] または [機能の取得] コマンドが送信されると、そのコマンドの完了キュー エントリの Dword 0 (DW0) フィールドにNVME_CDW11_FEATURE_NUMBER_OF_QUEUES構造体が返されます。

InterruptCoalescing

割り込みの合体設定を構成する値を含む NVME_CDW11_FEATURE_INTERRUPT_COALESCING 構造体を指定します。

割り込み結合フィーチャーに対してフィーチャーの取得コマンドが送信されると、NVME_CDW11_FEATURE_INTERRUPT_COALESCING構造体の TIME フィールドと THR フィールドで指定された値が、そのコマンドの完了キュー 項目の DW0 フィールドに返されます。

InterruptVectorConfig

特定の割り込みベクトルに固有の設定を構成する値を含む NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG構造体を 指定します。

割り込みベクトル構成フィーチャーに対してフィーチャーの取得コマンドが送信されると、NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG構造体の割り込みベクトル (IV) フィールドと結合無効化 (CD) フィールドで指定された値が、そのコマンドの完了キュー エントリの DW0 フィールドに返されます。

この機能を発行する前に、ホストは指定された割り込みベクトルを有効な I/O 完了キューで構成する必要があります。 指定された I/O 完了キューまたは割り込みベクトルが無効な場合、コントローラーは NVME_STATUS_INVALID_FIELD_IN_COMMAND の状態を返します。

LbaRangeType

[フィーチャの設定 ] コマンドで、LBA 範囲タイプ フィーチャーの LBA 範囲の数を指定する値を含むNVME_CDW11_FEATURE_LBA_RANGE_TYPE構造体を指定します。

このフィールドは[フィーチャの設定]コマンドでのみ使用され、[フィーチャの取得]コマンドでは無視されます。

LBA 範囲の種類機能は、指定された名前空間の一部である論理ブロック割り当て (LBA) 範囲の型と属性を指定します。 この機能では 、NVME_CDW11_FEATURE_LBA_RANGE_TYPE 構造体を使用して LBA 範囲の数を指定し、 NVME_LBA_RANGET_TYPE_ENTRY データ構造を使用して型と属性の情報を指定します。

LBA 範囲タイプフィーチャーに対してフィーチャーの取得コマンドが送信されると、NVME_CDW11_FEATURE_LBA_RANGE_TYPE構造の NUM フィールドに指定された値が入力候補キュー項目の DW0 フィールドに戻され、そのコマンドのデータ・バッファーに LBA 範囲タイプNVME_LBA_RANGET_TYPE_ENTRYデータ構造が戻されます。

Arbitration

コマンド・アービトレーションを制御する値を含む NVME_CDW11_FEATURE_ARBITRATION 構造体を指定します。

アービトレーション機能に対して機能の取得コマンドが送信されると、このフィールドで指定された構造が、そのコマンドの完了キュー 項目の DW0 フィールドに返されます。

VolatileWriteCache

コントローラー 上の揮発性 書き込みキャッシュ (存在する場合) を制御する値を含むNVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE構造体を指定します。

揮発性書き込みキャッシュ機能に対して Get Features コマンドが送信されると、そのコマンドの完了キュー エントリの DW0 フィールドに、NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHEの WCE フィールドで指定された値が返されます。

AsyncEventConfig

ホストへの非同期イベント 通知をトリガー するイベントを制御する非同期イベント構成機能のパラメーターを含むNVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG構造体を指定します。

非同期イベント構成機能に対して機能の取得コマンドが送信されると、そのコマンドの完了キュー エントリ構造の DW0 フィールドに、NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG構造体で指定された値が返されます。

PowerManagement

ホストが電源状態を構成できるようにする値を含む NVME_CDW11_FEATURE_POWER_MANAGEMENT 構造体を指定します。

Power Management 機能に対して [機能の取得] コマンドが送信されると、そのコマンドの入力候補キュー エントリの DW0 フィールドにNVME_CDW11_FEATURE_POWER_MANAGEMENT構造体が返されます。

AutoPowerStateTransition

自律電源状態遷移機能のパラメーターを含む NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION 構造を指定し、自律電源状態遷移の設定を構成します。

自律電源状態遷移機能は、 NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION データ構造と 自律電源状態遷移エントリ データ構造の属性情報を指定します。

自律電源状態遷移機能に対して機能の取得コマンドが送信されると、入力候補キュー エントリの DW0 フィールドにNVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION構造体の [APSTE] フィールドに指定された値が返され、そのコマンドのデータ バッファーにNVME_AUTO_POWER_STATE_TRANSITION_ENTRYデータ構造が返されます。

TemperatureThreshold

コントローラーの温度しきい値の設定または取得に使用される値を含む NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD 構造体を指定します。

ErrorRecovery

HostMemoryBuffer

ホスト メモリ バッファーの制御に使用される値を含む NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER 構造体を指定します。

ホスト メモリ バッファー機能は、コントローラーが排他的に使用するためにホスト メモリの一部を割り当てるメカニズムをホストに提供します。 ホスト メモリ バッファーを有効にする Set Features コマンドが正常に完了すると、ホスト メモリ バッファーが無効になるまで、ホストは関連付けられているホスト メモリ領域、バッファー サイズ、または記述子リストに書き込まれません。 ホスト メモリ バッファーを無効にする Set Features コマンドが正常に完了すると、ホスト メモリ バッファーが有効になるまで、コントローラーはホスト メモリ バッファー内のデータにアクセスしません。

ホスト メモリ記述子リストは、ホスト メモリ バッファーのアドレスと長さのペアを記述する、ホスト メモリ内の物理的に連続したデータ構造です。 リストの境界と内容は、次のフィールドと構造体で定義されます。

WriteAtomicityNormal

アトミック操作に対するコントローラーのサポートを定義する Atomic Write Unit Normal (AWUN) パラメーターと Namespace Atomic Write Unit Normal (NAWUN) パラメーターの操作を制御する値を含む NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL構造体を 指定します。

Write Atomicity Normal Feature に対して Get Features コマンドが送信されると、そのコマンドの完了キュー エントリ構造の DW0 フィールドに、NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL構造体で指定された値が返されます。

NonOperationalPowerState

非運用電源状態機能の値を含む NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE 構造体を指定します。このフィーチャーは、非運用電源状態に対して許容モードが有効かどうかを示します。

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

要件

要件 値
サポートされている最小のクライアント Windows 10
Header nvme.h

こちらもご覧ください