NVME_CDW11_FEATURES unione (nvme.h)

  • Articolo

Contiene i parametri per i comandi Get Features e Set Features che recuperano o impostano gli attributi della funzionalità specificata.

Questa struttura viene usata nel parametro CDW11 dei campi GETFEATURES e SETFEATURES nella struttura Comando.

Sintassi

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;

Members

NumberOfQueues

Specifica una struttura NVME_CDW11_FEATURE_NUMBER_OF_QUEUES contenente valori che indica il numero di code richieste dall'host per questo controller.

Quando viene inviato un comando Set Features o Get Features per la funzionalità Numero di code, la struttura NVME_CDW11_FEATURE_NUMBER_OF_QUEUES viene restituita nel campo Dword 0 (DW0) della voce Coda di completamento per tale comando.

InterruptCoalescing

Specifica una struttura NVME_CDW11_FEATURE_INTERRUPT_COALESCING contenente valori che configurano le impostazioni di unione degli interruzioni.

Quando viene inviato un comando Get Features per la funzionalità di carbone di interruzione, i valori specificati nei campi TIME e THR della struttura NVME_CDW11_FEATURE_INTERRUPT_COALESCING vengono restituiti nel campo DW0 della voce della coda di completamento per tale comando.

InterruptVectorConfig

Specifica una struttura NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG contenente valori che configurano le impostazioni specifiche di un determinato vettore di interruzione.

Quando viene inviato un comando Get Features per la funzionalità di configurazione del vettore di interruzione, i valori specificati nei campi Vector di interruzione (IV) e Coalescing Disabled (CD) della struttura NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG vengono restituiti nel campo DW0 della voce della coda di completamento per tale comando.

Prima di emettere questa funzionalità, l'host deve configurare il vettore di interruzione specificato con una coda di completamento di I/O valida. Se la coda di completamento di I/O o specificata non è valida, il controller restituirà uno stato di NVME_STATUS_INVALID_FIELD_IN_COMMAND.

LbaRangeType

Specifica una struttura NVME_CDW11_FEATURE_LBA_RANGE_TYPE contenente un valore che specifica il numero di intervalli LBA per la funzionalità Tipo di intervallo LBA nel comando Imposta funzionalità funzionalità.

Questo campo viene usato solo per il comando Imposta funzionalità e viene ignorato per il comando Recupera funzionalità.

La funzionalità Tipo di intervallo LBA specifica i tipi e gli attributi degli intervalli LBA (Logical Block Allocation) che fanno parte dello spazio dei nomi specificato. La funzionalità usa la struttura NVME_CDW11_FEATURE_LBA_RANGE_TYPE per specificare il numero di intervalli LBA e la struttura di dati NVME_LBA_RANGET_TYPE_ENTRY per specificare le informazioni sul tipo e sull'attributo.

Quando viene inviato un comando Get Features per la funzionalità Tipo di intervallo LBA, il valore specificato nel campo NUM della struttura NVME_CDW11_FEATURE_LBA_RANGE_TYPE viene restituito nel campo DW0 della voce Coda di completamento e la struttura di dati LBA Range Type NVME_LBA_RANGET_TYPE_ENTRY viene restituita nel buffer di dati per tale comando.

Arbitration

Specifica una struttura NVME_CDW11_FEATURE_ARBITRATION contenente valori che controllano l'arbitrato dei comandi.

Quando viene inviato un comando Get Features per la funzionalità Di arbitrato, la struttura specificata in questo campo viene restituita nel campo DW0 della voce Coda di completamento per tale comando.

VolatileWriteCache

Specifica una struttura NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE contenente valori che controllano la cache di scrittura volatile, se presente, nel controller.

Quando viene inviato un comando Get Features per la funzionalità Cache di scrittura volatile, il valore specificato nel campo WCE del NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE viene restituito nel campo DW0 della voce della coda di completamento per tale comando.

AsyncEventConfig

Specifica una struttura NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG contenente parametri per la funzionalità Configurazione eventi asincrona che controlla gli eventi che attivano una notifica di evento asincrona all'host.

Quando viene inviato un comando Get Features per la funzionalità Di configurazione eventi asincrona, i valori specificati nella struttura NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG vengono restituiti nel campo DW0 della struttura Della coda di completamento per tale comando.

PowerManagement

Specifica una struttura NVME_CDW11_FEATURE_POWER_MANAGEMENT contenente valori che consentono all'host di configurare lo stato di alimentazione.

Quando viene inviato un comando Get Features per la funzionalità Power Management, la struttura NVME_CDW11_FEATURE_POWER_MANAGEMENT viene restituita nel campo DW0 della voce Coda di completamento per tale comando.

AutoPowerStateTransition

Specifica una struttura NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION contenente i parametri per la funzionalità Di transizione autonoma dello stato di alimentazione che configura le impostazioni per le transizioni di stato di alimentazione autonome.

La funzionalità di transizione autonoma di Power State Transition specifica le informazioni sull'attributo nella struttura di dati NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION e nella struttura dati Di transizione autonoma di Power State Entry .

Quando viene inviato un comando Get Features per la funzionalità di transizione autonoma di Power State, il valore specificato nel campo APSTE della struttura NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION viene restituito nel campo DW0 della voce della coda di completamentoe la struttura di dati NVME_AUTO_POWER_STATE_TRANSITION_ENTRY viene restituita nel buffer dei dati per tale comando.

TemperatureThreshold

Specifica una struttura NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD contenente valori usati per impostare o recuperare i valori soglia di temperatura per il controller.

ErrorRecovery

HostMemoryBuffer

Specifica una struttura NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER contenente valori usati per controllare il buffer di memoria host.

La funzionalità Buffer memoria host fornisce un meccanismo per l'host per allocare una parte di memoria host per il controller da usare esclusivamente. Dopo il completamento di un comando Set Features che abilita il buffer di memoria host, l'host non scriverà nell'area di memoria host associata, dimensioni del buffer o elenco descrittore fino a quando il buffer di memoria host non è stato disabilitato. Dopo il completamento di un comando Set Features che disabilita il buffer di memoria host, il controller non accederà ai dati nel buffer di memoria host finché non è stato abilitato il buffer di memoria host.

L'elenco descrittore memoria host è una struttura di dati fisicamente contigua nella memoria host che descrive gli indirizzi e le coppie di lunghezza del buffer di memoria host. I limiti e il contenuto dell'elenco sono definiti nei campi e nelle strutture seguenti:

WriteAtomicityNormal

Specifica una struttura NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL contenente valori che controllano l'operazione dei parametri Atomic Write Unit Normal (AWUN) e Atomic Write Unit Normal (NAWUN) che definiscono il supporto del controller per le operazioni atomiche.

Quando viene inviato un comando Get Features per la funzionalità Normale di scrittura atomicità, i valori specificati nella struttura NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL vengono restituiti nel campo DW0 della struttura Della coda di completamento per tale comando.

NonOperationalPowerState

Specifica una struttura NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE contenente i valori per la funzionalità stato di alimentazione non operativa che indica se la modalità permissiva è abilitata per uno stato di alimentazione non operativo.

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Intestazione nvme.h

Vedi anche