STORAGE_PROTOCOL_NVME_DATA_TYPE-Enumeration (winioctl.h)

  • Artikel

Beschreibt den Typ der spezifischen Daten des NVMe-Protokolls, die während einer IOCTL_STORAGE_QUERY_PROPERTY-Anforderung abgefragt werden sollen.

Syntax

typedef enum _STORAGE_PROTOCOL_NVME_DATA_TYPE {
  NVMeDataTypeUnknown = 0,
  NVMeDataTypeIdentify,
  NVMeDataTypeLogPage,
  NVMeDataTypeFeature,
  NVMeDataTypeLogPageEx,
  NVMeDataTypeFeatureEx
} STORAGE_PROTOCOL_NVME_DATA_TYPE, *PSTORAGE_PROTOCOL_NVME_DATA_TYPE;

Konstanten

 
NVMeDataTypeUnknown
Wert: 0
Unbekannter Datentyp.
NVMeDataTypeIdentify
Identifizieren des Datentyps. Dies kann entweder Daten zum Identifizieren des Controllers oder Zum Identifizieren von Namespacedaten sein. Wenn diese Art von Daten abgefragt wird, weist das Feld ProtocolDataRequestValue von STORAGE_PROTOCOL_SPECIFIC_DATA den Wert NVME_IDENTIFY_CNS_CONTROLLER für Adapter oder NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE für Namespace auf. Wenn ProtocolDataRequestValue NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE ist, weist das ProtocolDataRequestSubValue-Feld aus der STORAGE_PROTOCOL_SPECIFIC_DATA-Struktur einen Wert der Namespace-ID auf.
NVMeDataTypeLogPage
Protokollseitendatentyp.
NVMeDataTypeFeature
Featuredatentyp.

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.

Um einen Typ von NVMe-protokollspezifischen Informationen anzugeben, konfigurieren Sie die Struktur STORAGE_PROTOCOL_SPECIFIC_DATA wie folgt:

  • 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.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen