STORAGE_PROTOCOL_DATA_DESCRIPTOR Struktur (winioctl.h)
Wird in Verbindung mit IOCTL_STORAGE_QUERY_PROPERTY zur Rückgabe protokollspezifischer Daten eines Speichergeräts oder Adapters verwendet. .
Syntax
typedef struct _STORAGE_PROTOCOL_DATA_DESCRIPTOR {
DWORD Version;
DWORD Size;
STORAGE_PROTOCOL_SPECIFIC_DATA ProtocolSpecificData;
} STORAGE_PROTOCOL_DATA_DESCRIPTOR, *PSTORAGE_PROTOCOL_DATA_DESCRIPTOR;
Member
Version
Die Version dieser Struktur.
Size
Die Gesamtgröße des Deskriptors, einschließlich des Speicherplatzes für alle Protokolldaten.
ProtocolSpecificData
Die protokollspezifischen Daten vom Typ STORAGE_PROTOCOL_SPECIFIC_DATA.
Hinweise
Wenn Sie IOCTL_STORAGE_QUERY_PROPERTY verwenden, um protokollspezifische Informationen im STORAGE_PROTOCOL_DATA_DESCRIPTOR abzurufen, konfigurieren Sie die STORAGE_PROPERTY_QUERY-Struktur wie folgt:
- Weisen Sie einen Puffer zu, der sowohl eine STORAGE_PROPERTY_QUERY als auch eine StrukturSTORAGE_PROTOCOL_SPECIFIC_DATA enthalten kann.
- Legen Sie das Feld PropertyID für eine Controller- bzw. Geräte-/Namespaceanforderung auf StorageAdapterProtocolSpecificProperty oder StorageDeviceProtocolSpecificProperty fest.
- Legen Sie das Feld QueryType auf PropertyStandardQuery fest.
- Füllen Sie die Struktur STORAGE_PROTOCOL_SPECIFIC_DATA mit den gewünschten Werten. Der Anfang der STORAGE_PROTOCOL_SPECIFIC_DATA ist das Feld AdditionalParameters von STORAGE_PROPERTY_QUERY.
- Legen Sie das Feld ProtocolType auf ProtocolTypeNVMe fest.
-
Legen Sie das Feld DataType auf einen durch STORAGE_PROTOCOL_NVME_DATA_TYPE definierten Enumerationswert fest:
- Verwenden Sie NVMeDataTypeIdentify, um Daten zum Identifizieren des Controllers oder zum Identifizieren von Namespacedaten abzurufen.
- Verwenden Sie NVMeDataTypeLogPage, um Protokollseiten (einschließlich SMART/Health-Daten) abzurufen.
- Verwenden Sie NVMeDataTypeFeature, um Features des NVMe-Laufwerks abzurufen.
- Legen Sie das Feld ProtocolType auf ProtocolTypeAta fest.
-
Legen Sie das Feld DataType auf einen Enumerationswert fest, der von STORAGE_PROTOCOL_ATA_DATA_TYPE definiert wird:
- Verwenden Sie AtaDataTypeIdentify , um das ATA-Laufwerk zu identifizieren.
- Verwenden Sie AtaDataTypeLogPage , um Protokollseiten vom ATA-Laufwerk abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Kopfzeile | winioctl.h (einschließlich Windows.h) |