struktur STORAGE_PROTOCOL_DATA_DESCRIPTOR (ntddstor.h)

Artikel
08/07/2023

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.