struktur STORAGE_PROTOCOL_DATA_DESCRIPTOR (ntddstor.h)
Struktur ini digunakan bersama dengan IOCTL_STORAGE_SET_PROPERTY dan IOCTL_STORAGE_QUERY_PROPERTY untuk mengatur atau mengkueri data khusus protokol dari perangkat penyimpanan atau adaptor.
Sintaks
typedef struct _STORAGE_PROTOCOL_DATA_DESCRIPTOR {
ULONG Version;
ULONG Size;
STORAGE_PROTOCOL_SPECIFIC_DATA ProtocolSpecificData;
} STORAGE_PROTOCOL_DATA_DESCRIPTOR, *PSTORAGE_PROTOCOL_DATA_DESCRIPTOR;
Anggota
Version
Versi struktur ini. Atur ke sizeof(STORAGE_PROTOCOL_DATA_DESCRIPTOR).
Size
Ukuran total dalam byte deskriptor, termasuk ruang untuk semua data protokol. Harus =>sizeof(STORAGE_PROTOCOL_DATA_DESCRIPTOR).
ProtocolSpecificData
Data khusus protokol, dari jenis STORAGE_PROTOCOL_SPECIFIC_DATA.
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.
Untuk menentukan jenis informasi khusus protokol ATA, konfigurasikan struktur STORAGE_PROTOCOL_SPECIFIC_DATA sebagai berikut:
- Atur bidang ProtocolType ke ProtocolTypeAta.
- Atur bidang DataType ke nilai enumerasi yang ditentukan oleh STORAGE_PROTOCOL_ATA_DATA_TYPE:
- Gunakan AtaDataTypeIdentify untuk mengidentifikasi drive ATA.
- Gunakan AtaDataTypeLogPage untuk mendapatkan halaman log dari drive ATA.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 |
Server minimum yang didukung | Server Windows 2016 |
Header | ntddstor.h (termasuk Ntddstor.h) |