enumerasi STORAGE_PROTOCOL_NVME_DATA_TYPE (ntddstor.h)

Artikel
03/05/2024

Menjelaskan jenis data khusus protokol NVMe yang akan dikueri selama permintaan IOCTL_STORAGE_QUERY_PROPERTY .

Sintaks

typedef enum _STORAGE_PROTOCOL_NVME_DATA_TYPE {
  NVMeDataTypeUnknown,
  NVMeDataTypeIdentify,
  NVMeDataTypeLogPage,
  NVMeDataTypeFeature
} STORAGE_PROTOCOL_NVME_DATA_TYPE, *PSTORAGE_PROTOCOL_NVME_DATA_TYPE;

Konstanta


`NVMeDataTypeUnknown` Tipe data tidak diketahui.
`NVMeDataTypeIdentify` Dapatkan data Identifikasi, yang dapat berupa data Pengontrol Identifikasi atau Identifikasi data Namespace. Ketika jenis data ini sedang dikueri, bidang dalam struktur STORAGE_PROTOCOL_SPECIFIC_DATA harus memiliki nilai berikut: * ProtocolDataRequestValue akan NVME_IDENTIFY_CNS_CONTROLLER untuk adaptor atau NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE untuk namespace. * Jika ProtocolDataRequestValueNVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE, bidang ProtocolDataRequestSubValue menentukan ID namespace layanan. (Perhatikan bahwa NVME_IDENTIFY_CNS_ACTIVE_NAMESPACES saat ini tidak didukung.)
`NVMeDataTypeLogPage` Dapatkan halaman log NVMe. Ketika jenis data ini sedang dikueri, bidang dalam struktur STORAGE_PROTOCOL_SPECIFIC_DATA harus memiliki nilai berikut: * ProtocolDataRequestValue adalah pengidentifikasi halaman log yang akan diambil. * ProtocolDataRequestSubValue adalah nilai 32-bit yang lebih rendah dari offset dalam halaman log tempat mulai mengembalikan data. * ProtocolDataRequestSubValue2 adalah nilai offset 32-bit atas dalam halaman log tempat mulai mengembalikan data. * ProtocolDataRequestSubValue3 adalah pengidentifikasi khusus log yang diperlukan untuk halaman log tertentu. * ProtocolDataRequestSubValue4 adalah struktur STORAGE_PROTOCOL_DATA_SUBVALUE_GET_LOG_PAGE yang memungkinkan informasi tambahan ditentukan saat mendapatkan halaman log.
`NVMeDataTypeFeature` Jenis data fitur.

Keterangan

Saat menggunakan IOCTL_STORAGE_QUERY_PROPERTY untuk mengambil informasi khusus protokol di STORAGE_PROTOCOL_DATA_DESCRIPTOR, konfigurasikan struktur STORAGE_PROPERTY_QUERY sebagai berikut:

Alokasikan buffer yang dapat berisi struktur STORAGE_PROPERTY_QUERY dan STORAGE_PROTOCOL_SPECIFIC_DATA .
Atur bidang PropertyID ke StorageAdapterProtocolSpecificProperty atau StorageDeviceProtocolSpecificProperty untuk permintaan pengontrol atau perangkat/namespace.
Atur bidang QueryType ke PropertyStandardQuery.
Isi struktur STORAGE_PROTOCOL_SPECIFIC_DATA dengan nilai yang diinginkan. Awal STORAGE_PROTOCOL_SPECIFIC_DATA adalah bidang AdditionalParametersdari STORAGE_PROPERTY_QUERY.

Untuk menentukan jenis informasi khusus protokol NVMe, konfigurasikan struktur STORAGE_PROTOCOL_SPECIFIC_DATA sebagai berikut:

Atur bidang ProtocolType ke ProtocolTypeNVMe.
Atur bidang DataType ke nilai enumerasi yang ditentukan oleh STORAGE_PROTOCOL_NVME_DATA_TYPE:
- Gunakan NVMeDataTypeIdentify untuk mendapatkan data Identifi Controller atau Mengidentifikasi data Namespace.
- Gunakan NVMeDataTypeLogPage untuk mendapatkan halaman log (termasuk data SMART/health).
- Gunakan NVMeDataTypeFeature untuk mendapatkan fitur drive NVMe.