Bagikan melalui

NVME_CDW11_FEATURES union (nvme.h)

  • Artikel

Berisi parameter untuk perintah Dapatkan Fitur dan Atur Fitur yang mengambil atau mengatur atribut fitur yang ditentukan.

Struktur ini digunakan dalam parameter CDW11 dari bidang GETFEATURES dan SETFEATURES dalam struktur Perintah .

Sintaks

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;

Anggota

NumberOfQueues

Menentukan struktur NVME_CDW11_FEATURE_NUMBER_OF_QUEUES yang berisi nilai yang menunjukkan jumlah antrean yang diminta host untuk pengontrol ini.

Saat perintah Atur Fitur atau Dapatkan Fitur dikirimkan untuk Fitur Jumlah Antrean, struktur NVME_CDW11_FEATURE_NUMBER_OF_QUEUES dikembalikan di bidang Dword 0 (DW0) dari entri Antrean Penyelesaian untuk perintah tersebut.

InterruptCoalescing

Menentukan struktur NVME_CDW11_FEATURE_INTERRUPT_COALESCING yang berisi nilai yang mengonfigurasi pengaturan coalescing interupsi.

Saat perintah Dapatkan Fitur dikirimkan untuk Interupsi Fitur Coalescing, nilai yang ditentukan dalam bidang TIME dan THR dari struktur NVME_CDW11_FEATURE_INTERRUPT_COALESCING dikembalikan di bidang DW0dari Entri Antrean Penyelesaian untuk perintah tersebut.

InterruptVectorConfig

Menentukan struktur NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG yang berisi nilai yang mengonfigurasi pengaturan khusus untuk vektor interupsi tertentu.

Ketika perintah Dapatkan Fitur dikirimkan untuk Fitur Konfigurasi Vektor Interupsi, nilai yang ditentukan dalam bidang Vektor Interupsi (IV) dan Coalescing Disabled (CD) dari struktur NVME_CDW11_FEATURE_INTERRUPT_VECTOR_CONFIG dikembalikan di bidang DW0 dari Entri Antrean Penyelesaian untuk perintah tersebut.

Sebelum mengeluarkan fitur ini, host harus mengonfigurasi Vektor Interupsi yang ditentukan dengan Antrean Penyelesaian I/O yang valid. Jika Antrean Penyelesaian I/O atau Vektor Interupsi yang ditentukan tidak valid, pengontrol akan mengembalikan status NVME_STATUS_INVALID_FIELD_IN_COMMAND.

LbaRangeType

Menentukan struktur NVME_CDW11_FEATURE_LBA_RANGE_TYPE yang berisi nilai yang menentukan jumlah rentang LBA untuk Fitur Jenis Rentang LBA dalam perintah Atur Fitur.

Bidang ini hanya digunakan untuk perintah Atur Fitur dan diabaikan untuk perintah Dapatkan Fitur.

Fitur Jenis Rentang LBA menentukan jenis dan atribut rentang Alokasi Blok Logis (LBA) yang merupakan bagian dari namespace yang ditentukan. Fitur ini menggunakan struktur NVME_CDW11_FEATURE_LBA_RANGE_TYPE untuk menentukan jumlah rentang LBA, dan struktur data NVME_LBA_RANGET_TYPE_ENTRY untuk menentukan informasi jenis dan atribut.

Saat perintah Dapatkan Fitur dikirimkan untuk fitur Jenis Rentang LBA, nilai yang ditentukan di bidang NUM struktur NVME_CDW11_FEATURE_LBA_RANGE_TYPE dikembalikan di bidang DW0entri Antrean Penyelesaian, dan struktur data jenis rentang LBA NVME_LBA_RANGET_TYPE_ENTRY dikembalikan dalam buffer data untuk perintah tersebut.

Arbitration

Menentukan struktur NVME_CDW11_FEATURE_ARBITRATION yang berisi nilai yang mengontrol arbitrase perintah.

Saat perintah Dapatkan Fitur dikirimkan untuk fitur Arbitrase, struktur yang ditentukan dalam bidang ini dikembalikan di bidang DW0 dari entri Antrean Penyelesaian untuk perintah tersebut.

VolatileWriteCache

Menentukan struktur NVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE yang berisi nilai yang mengontrol cache tulis volatil, jika ada, pada pengontrol.

Ketika perintah Dapatkan Fitur dikirimkan untuk Fitur Cache Tulis Volatil, nilai yang ditentukan di bidang WCENVME_CDW11_FEATURE_VOLATILE_WRITE_CACHE dikembalikan di bidang DW0 dari Entri Antrean Penyelesaian untuk perintah tersebut.

AsyncEventConfig

Menentukan struktur NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG yang berisi parameter untuk Fitur Konfigurasi Peristiwa Asinkron yang mengontrol peristiwa yang memicu pemberitahuan peristiwa asinkron ke host.

Saat perintah Dapatkan Fitur dikirimkan untuk Fitur Konfigurasi Peristiwa Asinkron, nilai yang ditentukan dalam struktur NVME_CDW11_FEATURE_ASYNC_EVENT_CONFIG dikembalikan di bidang DW0 dari struktur Entri Antrean Penyelesaian untuk perintah tersebut.

PowerManagement

Menentukan struktur NVME_CDW11_FEATURE_POWER_MANAGEMENT yang berisi nilai yang memungkinkan host mengonfigurasi status daya.

Saat perintah Dapatkan Fitur dikirimkan untuk fitur Power Management, struktur NVME_CDW11_FEATURE_POWER_MANAGEMENT dikembalikan di bidang DW0 dari entri Antrean Penyelesaian untuk perintah tersebut.

AutoPowerStateTransition

Menentukan struktur NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION yang berisi parameter untuk Fitur Transisi Status Daya Otonom yang mengonfigurasi pengaturan untuk transisi status daya otonom.

Fitur Transisi Status Daya Otonom menentukan informasi atribut dalam struktur data NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION dan struktur data Entri Transisi Status Daya Otonom .

Saat perintah Dapatkan Fitur dikirimkan untuk Fitur Transisi Status Daya Otonom, nilai yang ditentukan di bidang APSTE dari struktur NVME_CDW11_FEATURE_AUTO_POWER_STATE_TRANSITION dikembalikan di bidang DW0dari Entri Antrean Penyelesaian, dan struktur data NVME_AUTO_POWER_STATE_TRANSITION_ENTRY dikembalikan dalam buffer data untuk perintah tersebut.

TemperatureThreshold

Menentukan struktur NVME_CDW11_FEATURE_TEMPERATURE_THRESHOLD yang berisi nilai yang digunakan untuk mengatur atau mengambil nilai ambang suhu untuk pengontrol.

ErrorRecovery

HostMemoryBuffer

Menentukan struktur NVME_CDW11_FEATURE_HOST_MEMORY_BUFFER yang berisi nilai yang digunakan untuk mengontrol Buffer Memori Host.

Fitur Buffer Memori Host menyediakan mekanisme bagi host untuk mengalokasikan sebagian memori host untuk digunakan pengontrol secara eksklusif. Setelah berhasil menyelesaikan perintah Atur Fitur yang memungkinkan buffer memori host, host tidak akan menulis ke wilayah memori host terkait, ukuran buffer, atau daftar deskriptor hingga buffer memori host dinonaktifkan. Setelah berhasil menyelesaikan perintah Set Features yang menonaktifkan buffer memori host, pengontrol tidak akan mengakses data apa pun di buffer memori host hingga buffer memori host diaktifkan.

Daftar Deskriptor Memori Host adalah struktur data yang berdekatan secara fisik dalam memori host yang menjelaskan alamat dan pasangan panjang Buffer Memori Host. Batas dan konten daftar ditentukan dalam bidang dan struktur berikut:

WriteAtomicityNormal

Menentukan struktur NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL yang berisi nilai yang mengontrol pengoperasian parameter Atomic Write Unit Normal (AWUN) dan Namespace Atomic Write Unit Normal (NAWUN) yang menentukan dukungan pengontrol untuk operasi atom.

Saat perintah Dapatkan Fitur dikirimkan untuk Fitur Normal AtomItas Tulis, nilai yang ditentukan dalam struktur NVME_CDW11_FEATURE_WRITE_ATOMICITY_NORMAL dikembalikan di bidang DW0 dari struktur Entri Antrean Penyelesaian untuk perintah tersebut.

NonOperationalPowerState

Menentukan struktur NVME_CDW11_FEATURE_NON_OPERATIONAL_POWER_STATE yang berisi nilai untuk Fitur Status Daya Non-Operasional yang menunjukkan apakah mode permisif diaktifkan untuk status daya yang tidak beroperasi.

IoCommandSetProfile

ErrorInjection

HostIdentifier

ReservationPersistence

ReservationNotificationMask

GetHostMetadata

SetHostMetadata

AsUlong

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Header nvme.h

Lihat juga