unión NVME_CDW11_FEATURES (nvme.h)

  • Artículo

Contiene parámetros para los comandos Obtener características y Establecer características que recuperan o establecen los atributos de la característica especificada.

Esta estructura se usa en el parámetro CDW11 de los campos GETFEATURES y SETFEATURES en la estructura Command .

Sintaxis

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;

Miembros

NumberOfQueues

Especifica una estructura de NVME_CDW11_FEATURE_NUMBER_OF_QUEUES que contiene valores que indican el número de colas que el host solicita para este controlador.

Cuando se envía un comando Establecer características u Obtener características para la característica Número de colas, la estructura NVME_CDW11_FEATURE_NUMBER_OF_QUEUES se devuelve en el campo Dword 0 (DW0) de la entrada Cola de finalización para ese comando.

InterruptCoalescing

Especifica una estructura de NVME_CDW11_FEATURE_INTERRUPT_COALESCING que contiene valores que configuran las opciones de fusión de interrupciones.

Cuando se envía un comando Obtener características para la característica de fusión de interrupciones, los valores especificados en los campos TIME y THR de la estructura de NVME_CDW11_FEATURE_INTERRUPT_COALESCING se devuelven en el campo DW0 de la entrada de cola de finalización para ese comando.

InterruptVectorConfig

Especifica una estructura de NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG que contiene valores que configuran valores específicos de un vector de interrupción determinado.

Cuando se envía un comando Get Features para la característica de configuración de vectores de interrupción, los valores especificados en los campos Vector de interrupción (IV) y Coalescing Disabled (CD) de la estructura de NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG se devuelven en el campo DW0 de la entrada de cola de finalización para ese comando.

Antes de emitir esta característica, el host debe configurar el vector de interrupción especificado con una cola de finalización de E/S válida. Si la cola de finalización de E/S o vector de interrupción especificado no es válida, el controlador devolverá un estado de NVME_STATUS_INVALID_FIELD_IN_COMMAND.

LbaRangeType

Especifica una estructura de NVME_CDW11_FEATURE_LBA_RANGE_TYPE que contiene un valor que especifica el número de intervalos LBA para la característica tipo de intervalo LBA en el comando Establecer características.

Este campo se usa solo para el comando Establecer características y se omite para el comando Obtener características.

La característica Tipo de intervalo LBA especifica el tipo y los atributos de los intervalos de asignación de bloques lógicos (LBA) que forman parte del espacio de nombres especificado. La característica usa la estructura NVME_CDW11_FEATURE_LBA_RANGE_TYPE para especificar el número de intervalos LBA y la estructura de datos NVME_LBA_RANGET_TYPE_ENTRY para especificar la información de tipo y atributo.

Cuando se envía un comando Get Features para la característica Tipo de intervalo LBA, el valor especificado en el campo NUM de la estructura de NVME_CDW11_FEATURE_LBA_RANGE_TYPE se devuelve en el campo DW0 de la entrada Cola de finalización y el tipo de intervalo LBA NVME_LBA_RANGET_TYPE_ENTRY estructura de datos se devuelve en el búfer de datos de ese comando.

Arbitration

Especifica una estructura de NVME_CDW11_FEATURE_ARBITRATION que contiene valores que controlan el arbitraje de comandos.

Cuando se envía un comando Obtener características para la característica de arbitraje, la estructura especificada en este campo se devuelve en el campo DW0 de la entrada Cola de finalización para ese comando.

VolatileWriteCache

Especifica una estructura de NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE que contiene valores que controlan la caché de escritura volátil, si está presente, en el controlador.

Cuando se envía un comando Obtener características para la característica caché de escritura volátil, el valor especificado en el campo WCE del NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE se devuelve en el campo DW0 de la entrada de cola de finalización para ese comando.

AsyncEventConfig

Especifica una estructura de NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG que contiene parámetros para la característica de configuración de eventos asincrónica que controla los eventos que desencadenan una notificación de eventos asincrónica al host.

Cuando se envía un comando Get Features para la característica de configuración de eventos asincrónica, los valores especificados en La estructura NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG se devuelven en el campo DW0 de la estructura De entrada de cola de finalización para ese comando.

PowerManagement

Especifica una estructura NVME_CDW11_FEATURE_POWER_MANAGEMENT que contiene valores que permiten al host configurar el estado de energía.

Cuando se envía un comando Get Features para la característica De administración de energía, la estructura NVME_CDW11_FEATURE_POWER_MANAGEMENT se devuelve en el campo DW0 de la entrada Cola de finalización para ese comando.

AutoPowerStateTransition

Especifica una estructura de NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION que contiene parámetros para la característica de transición de estado de energía autónoma que configura las opciones para las transiciones de estado de energía autónoma.

La característica De transición de estado de energía autónoma especifica la información de atributo en la estructura de datos NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION y la estructura de datos de entrada de transición de estado de energía autónoma .

Cuando se envía un comando Get Features para la característica de transición de estado de energía autónoma, el valor especificado en el campo APSTE de la estructura de NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION se devuelve en el campo DW0 de la entrada de cola de finalización y la estructura de datos NVME_AUTO_POWER_STATE_TRANSITION_ENTRY se devuelve en el búfer de datos para ese comando.

TemperatureThreshold

Especifica una estructura de NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD que contiene valores que se usan para establecer o recuperar valores de umbral de temperatura para el controlador.

ErrorRecovery

HostMemoryBuffer

Especifica una estructura de NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER que contiene valores que se usan para controlar el búfer de memoria del host.

La característica Búfer de memoria del host proporciona un mecanismo para que el host asigne una parte de la memoria del host para que el controlador lo use exclusivamente. Después de completar correctamente un comando Establecer características que habilita el búfer de memoria del host, el host no escribirá en la región de memoria del host asociada, el tamaño del búfer o la lista de descriptores hasta que se haya deshabilitado el búfer de memoria del host. Después de completar correctamente un comando Establecer características que deshabilita el búfer de memoria del host, el controlador no tendrá acceso a ningún dato del búfer de memoria del host hasta que se haya habilitado el búfer de memoria del host.

La lista de descriptores de memoria de host es una estructura de datos físicamente contigua en la memoria del host que describe los pares de dirección y longitud del búfer de memoria del host. Los límites y el contenido de la lista se definen en los campos y estructuras siguientes:

WriteAtomicityNormal

Especifica una estructura de NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL que contiene valores que controlan la operación de los parámetros Atomic Write Unit Normal (AWUN) y Namespace Atomic Write Unit Normal (NAWUN) que definen la compatibilidad del controlador con las operaciones atómicas.

Cuando se envía un comando Get Features para la característica Normal de escritura atómica, los valores especificados en La estructura NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL se devuelven en el campo DW0 de la estructura De entrada de cola de finalización para ese comando.

NonOperationalPowerState

Especifica una estructura NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE que contiene valores para la característica estado de energía no operativa que indica si el modo permisivo está habilitado para un estado de energía no operativo.

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Encabezado nvme.h

Consulte también