NVME_CDW11_FEATURES Union (nvme.h)

  • Artikel

Enthält Parameter für die Befehle Features abrufen und Features festlegen, die die Attribute des angegebenen Features abrufen oder festlegen.

Diese Struktur wird im CDW11-Parameter der Felder GETFEATURES und SETFEATURES in der Befehlsstruktur verwendet.

Syntax

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;

Member

NumberOfQueues

Gibt eine NVME_CDW11_FEATURE_NUMBER_OF_QUEUES-Struktur an, die Werte enthält, die die Anzahl der Warteschlangen angibt, die der Host für diesen Controller anfordert.

Wenn ein Befehl Features festlegen oder Features abrufen für das Feature Anzahl von Warteschlangen übermittelt wird, wird die NVME_CDW11_FEATURE_NUMBER_OF_QUEUES-Struktur im Feld Dword 0 (DW0) des Eintrags "Vervollständigungswarteschlange " für diesen Befehl zurückgegeben.

InterruptCoalescing

Gibt eine NVME_CDW11_FEATURE_INTERRUPT_COALESCING-Struktur an, die Werte enthält, die die Einstellungen für das Zusammenfügen von Unterbrechungen konfigurieren.

Wenn ein Befehl Features abrufen für das Interrupt-Koalescing-Feature übermittelt wird, werden die Werte, die in den Feldern TIME und THR der NVME_CDW11_FEATURE_INTERRUPT_COALESCING-Struktur angegeben sind, im Feld DW0 des Vervollständigungswarteschlangeneintrags für diesen Befehl zurückgegeben.

InterruptVectorConfig

Gibt eine NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG-Struktur an, die Werte enthält, die einstellungen für einen bestimmten Unterbrechungsvektor konfigurieren.

Wenn ein Befehl Features abrufen für das Interrupt Vector Configuration Feature übermittelt wird, werden die Werte, die in den Feldern Interrupt Vector (IV) und Coalescing Disabled (CD) der NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG-Struktur angegeben sind, im Feld DW0 des Vervollständigungswarteschlangeneintrags für diesen Befehl zurückgegeben.

Vor der Ausgabe dieses Features sollte der Host den angegebenen Interruptvektor mit einer gültigen E/A-Vervollständigungswarteschlange konfigurieren. Wenn die angegebene E/A-Vervollständigungswarteschlange oder der angegebene Interrupt vector ungültig ist, gibt der Controller eine status NVME_STATUS_INVALID_FIELD_IN_COMMAND zurück.

LbaRangeType

Gibt eine NVME_CDW11_FEATURE_LBA_RANGE_TYPE Struktur an, die einen Wert enthält, der die Anzahl der LBA-Bereiche für das LBA-Bereichstypfeature im Befehl Features festlegen angibt.

Dieses Feld wird nur für den Befehl Features festlegen verwendet und für den Befehl Features abrufen ignoriert.

Das Feature LBA-Bereichstyp gibt Typ und Attribute von LBA-Bereichen (Logical Block Allocation) an, die Teil des angegebenen Namespace sind. Das Feature verwendet die NVME_CDW11_FEATURE_LBA_RANGE_TYPE-Struktur , um die Anzahl der LBA-Bereiche anzugeben, und die NVME_LBA_RANGET_TYPE_ENTRY Datenstruktur, um die Typ- und Attributinformationen anzugeben.

Wenn ein Befehl Features abrufen für das LBA-Feature Bereichstyp übermittelt wird, wird der im Feld NUM der NVME_CDW11_FEATURE_LBA_RANGE_TYPE-Struktur angegebene Wert im Feld DW0 des Eintrags Vervollständigungswarteschlange zurückgegeben, und der LBA-Bereichstyp NVME_LBA_RANGET_TYPE_ENTRY Datenstruktur wird im Datenpuffer für diesen Befehl zurückgegeben.

Arbitration

Gibt eine NVME_CDW11_FEATURE_ARBITRATION-Struktur an, die Werte enthält, die die Befehlsschiedssetzung steuern.

Wenn ein Befehl Features abrufen für das Schiedsfeature übermittelt wird, wird die in diesem Feld angegebene Struktur im Feld DW0 des Eintrags Vervollständigungswarteschlange für diesen Befehl zurückgegeben.

VolatileWriteCache

Gibt eine NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE-Struktur an, die Werte enthält, die den flüchtigen Schreibcache steuern, sofern vorhanden, auf dem Controller.

Wenn ein Befehl Features abrufen für das Feature für flüchtige Schreibcaches übermittelt wird, wird der im WCE-Feld des NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE angegebene Wert im Feld DW0 des Eintrags für die Vervollständigungswarteschlange für diesen Befehl zurückgegeben.

AsyncEventConfig

Gibt eine NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG-Struktur an, die Parameter für das Feature "Asynchrone Ereigniskonfiguration" enthält, das die Ereignisse steuert, die eine asynchrone Ereignisbenachrichtigung für den Host auslösen.

Wenn ein Befehl Zum Abrufen von Features für das Feature für die asynchrone Ereigniskonfiguration übermittelt wird, werden die unter Die NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG-Struktur angegebenen Werte im Feld DW0 der Struktur "Vervollständigungswarteschlangeneintrag" für diesen Befehl zurückgegeben.

PowerManagement

Gibt eine NVME_CDW11_FEATURE_POWER_MANAGEMENT-Struktur an, die Werte enthält, mit denen der Host den Energiezustand konfigurieren kann.

Wenn ein Befehl Features abrufen für das Power Management-Feature übermittelt wird, wird die NVME_CDW11_FEATURE_POWER_MANAGEMENT-Struktur im Feld DW0 des Eintrags "Vervollständigungswarteschlange" für diesen Befehl zurückgegeben.

AutoPowerStateTransition

Gibt eine NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION-Struktur an, die Parameter für das Feature zum Übergang zum autonomen Energiezustand enthält, das die Einstellungen für autonome Energiezustandsübergänge konfiguriert.

Das Feature für den Übergang zum autonomen Energiezustand gibt die Attributinformationen in der NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION Datenstruktur und der Datenstruktur des Autonomen Energiezustandsübergangs an .

Wenn ein Befehl "Features abrufen" für das Feature "Autonomer Energiezustandsübergang" übermittelt wird, wird der im Feld APSTE der NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION-Struktur angegebene Wert im Feld DW0 des Vervollständigungswarteschlangeneintrags zurückgegeben, und die NVME_AUTO_POWER_STATE_TRANSITION_ENTRY Datenstruktur wird im Datenpuffer für diesen Befehl zurückgegeben.

TemperatureThreshold

Gibt eine NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD-Struktur an, die Werte enthält, die zum Festlegen oder Abrufen von Temperaturschwellenwerten für den Controller verwendet werden.

ErrorRecovery

HostMemoryBuffer

Gibt eine NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER-Struktur an, die Werte enthält, die zum Steuern des Hostspeicherpuffers verwendet werden.

Das Feature Hostspeicherpuffer bietet einen Mechanismus für den Host, um einen Teil des Hostspeichers für den Controller exklusiv zuzuweisen. Nach erfolgreichem Abschluss des Befehls Features festlegen, der den Hostspeicherpuffer aktiviert, schreibt der Host nicht in die zugehörige Hostspeicherregion, Puffergröße oder Deskriptorliste, bis der Hostspeicherpuffer deaktiviert wurde. Nach erfolgreichem Abschluss des Befehls Features festlegen, mit dem der Hostspeicherpuffer deaktiviert wird, greift der Controller erst dann auf Daten im Hostspeicherpuffer zu, wenn der Hostspeicherpuffer aktiviert wurde.

Die Hostspeicherdeskriptorliste ist eine physisch zusammenhängende Datenstruktur im Hostspeicher, die die Adress- und Längenpaare des Hostspeicherpuffers beschreibt. Die Grenzen und Inhalte der Liste werden in folgenden Feldern und Strukturen definiert:

WriteAtomicityNormal

Gibt eine NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL-Struktur mit Werten an, die den Betrieb der Parameter Atomic Write Unit Normal (AWUN) und Namespace Atomic Write Unit Normal (NAWUN) steuern, die die Unterstützung des Controllers für atomare Vorgänge definieren.

Wenn ein Befehl Features abrufen für das Write Atomicity Normal Feature übermittelt wird, werden die unter Die NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL-Struktur angegebenen Werte im Feld DW0 der Struktur " Vervollständigungswarteschlangeneintrag" für diesen Befehl zurückgegeben.

NonOperationalPowerState

Gibt eine NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE-Struktur an, die Werte für das Feature "Nicht betriebsbereiter Energiezustand" enthält, das angibt, ob der freizügige Modus für einen nicht betriebsfähigen Energiezustand aktiviert ist.

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Kopfzeile nvme.h

Weitere Informationen