NVME_CDW11_FEATURES union (nvme.h)
Содержит параметры для команд Get Features и Set Features, которые извлекают или задают атрибуты указанного компонента.
Эта структура используется в параметре CDW11 полей GETFEATURES и SETFEATURES в структуре команд .
Синтаксис
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 , содержащую значения, указывающие количество очередей, запрашиваемых узлом для этого контроллера.
При отправке команды Set Features или Get Features для компонента Number of Queues (Число очередей) NVME_CDW11_FEATURE_NUMBER_OF_QUEUES структура возвращается в поле Dword 0 (DW0) записи Очередь завершения для этой команды.
InterruptCoalescing
Задает структуру NVME_CDW11_FEATURE_INTERRUPT_COALESCING , содержащую значения, которые настраивают параметры объединения прерываний.
При отправке команды Get Features для функции объединения прерываний значения, указанные в полях TIME и THR структуры NVME_CDW11_FEATURE_INTERRUPT_COALESCING , возвращаются в поле DW0записи очереди завершения для этой команды.
InterruptVectorConfig
Задает структуру NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG , содержащую значения, которые настраивают параметры, относящиеся к конкретному вектору прерывания.
При отправке команды Get Features для компонента конфигурации векторов прерываний значения, указанные в полях Вектор прерываний (IV) и Отключено объединения (CD) структуры NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG , возвращаются в поле DW0записи очереди завершения для этой команды.
Перед выпуском этой функции узел должен настроить указанный вектор прерываний с допустимой очередью завершения ввода-вывода. Если указана недопустимая очередь завершения ввода-вывода или вектор прерывания, контроллер вернет состояние NVME_STATUS_INVALID_FIELD_IN_COMMAND.
LbaRangeType
Задает структуру NVME_CDW11_FEATURE_LBA_RANGE_TYPE , содержащую значение, указывающее количество диапазонов LBA для компонента типа диапазона LBA в команде Задать компоненты.
Это поле используется только для команды Задать компоненты и игнорируется для команды Get Features.
Функция LBA Range Type (Тип диапазона LBA) определяет тип и атрибуты диапазонов выделения логических блоков (LBA), которые являются частью указанного пространства имен. Функция использует структуру NVME_CDW11_FEATURE_LBA_RANGE_TYPE для указания количества диапазонов LBA, а NVME_LBA_RANGET_TYPE_ENTRY структуру данных для указания сведений о типе и атрибуте.
При отправке команды Get Features для функции Типа диапазона LBA значение, указанное в поле NUMструктуры NVME_CDW11_FEATURE_LBA_RANGE_TYPE , возвращается в поле DW0записи Очередь завершения, а тип диапазона LBA NVME_LBA_RANGET_TYPE_ENTRY структура данных возвращается в буфере данных для этой команды.
Arbitration
Указывает структуру NVME_CDW11_FEATURE_ARBITRATION , содержащую значения, управляющие арбитражем команд.
При отправке команды Get Features для функции арбитража структура, указанная в этом поле, возвращается в поле DW0записи Очередь завершения для этой команды.
VolatileWriteCache
Задает структуру NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE , содержащую значения, управляющие энергонезависимым кэшем записи, если он имеется на контроллере.
При отправке команды Get Features для компонента энергонезависимого кэша записи значение, указанное в поле WCENVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE , возвращается в поле DW0записи очереди завершения для этой команды.
AsyncEventConfig
Задает структуру NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG , содержащую параметры для компонента конфигурации асинхронных событий, который управляет событиями, которые активируют асинхронное уведомление о событии для узла.
При отправке команды Get Features для компонента асинхронной конфигурации событий значения, указанные в разделе Структура NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG , возвращаются в поле DW0 структуры записи очереди завершения для этой команды.
PowerManagement
Задает структуру NVME_CDW11_FEATURE_POWER_MANAGEMENT , содержащую значения, позволяющие узлу настраивать состояние питания.
При отправке команды Get Features для функции управления питанием структура NVME_CDW11_FEATURE_POWER_MANAGEMENT возвращается в поле DW0записи Очередь завершения для этой команды.
AutoPowerStateTransition
Указывает структуру NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION , содержащую параметры для функции перехода состояния автономного питания, которая настраивает параметры для переходов состояния автономного питания.
Функция перехода состояния автономной власти указывает сведения об атрибутах в структуре данных NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION и в структуре данных для перехода состояния автономной власти .
При отправке команды Get Features для функции перехода с автономным состоянием питания значение, указанное в поле APSTE структуры NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION , возвращается в поле DW0записи очереди завершения, а структура данных NVME_AUTO_POWER_STATE_TRANSITION_ENTRY возвращается в буфер данных для этой команды.
TemperatureThreshold
Задает структуру NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD , содержащую значения, используемые для установки или получения пороговых значений температуры для контроллера.
ErrorRecovery
HostMemoryBuffer
Указывает структуру NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER , содержащую значения, используемые для управления буфером памяти узла.
Функция буфера памяти узла предоставляет узлу механизм выделения части памяти узла для использования контроллером исключительно. После успешного выполнения команды Set Features, которая включает буфер памяти узла, узел не будет выполнять запись в соответствующую область памяти узла, размер буфера или список дескрипторов, пока буфер памяти узла не будет отключен. После успешного выполнения команды Set Features, которая отключает буфер памяти узла, контроллер не будет обращаться к данным в буфере памяти узла, пока буфер памяти узла не будет включен.
Список дескрипторов памяти узла — это физически непрерывная структура данных в памяти узла, которая описывает пары адреса и длины буфера памяти узла. Границы и содержимое списка определяются в следующих полях и структурах:
- Нижние границы адреса списка дескриптора памяти узла определяются в поле HMDLLANVME_CDW13_FEATURE_HOST_MEMORY_BUFFER.
- Верхние границы адреса списка дескрипторов памяти узла определяются в поле HMDLUANVME_CDW14_FEATURE_HOST_MEMORY_BUFFER.
- Число адресов и пар длины для списка дескрипторов памяти узла указывается в поле Число записей списка дескрипторов памяти узла в поле HMDLECNVME_CDW15_FEATURE_HOST_MEMORY_BUFFER.
- Поля для записи в списке дескрипторов памяти узла указываются в структуре NVME_HOST_MEMORY_BUFFER_DESCRIPTOR_ENTRY .
WriteAtomicityNormal
Указывает структуру NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL , содержащую значения, управляющие операцией параметров Atomic Write Unit Normal (AWUN) и Namespace Atomic Write Unit Normal (NAWUN), которые определяют поддержку контроллером атомарных операций.
При отправке команды Get Features для функции Write Atomicity Normal значения, указанные в разделе Структура NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL , возвращаются в поле DW0 структуры записи очереди завершения для этой команды.
NonOperationalPowerState
Указывает структуру NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE , содержащую значения для функции состояния нерабочей мощности, которая указывает, включен ли разрешительный режим для нерабочего состояния питания.
IoCommandSetProfile
ErrorInjection
HostIdentifier
ReservationPersistence
ReservationNotificationMask
GetHostMetadata
SetHostMetadata
AsUlong
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 |
| Верхняя часть | nvme.h |