STORAGE_PROTOCOL_NVME_DATA_TYPE Enumeration (winioctl.h)

  • Artikel

Beschreibt den Typ der protokollspezifischen NVMe-Daten , 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
} STORAGE_PROTOCOL_NVME_DATA_TYPE, *PSTORAGE_PROTOCOL_NVME_DATA_TYPE;

Konstanten

 
NVMeDataTypeUnknown
Wert: 0
Unbekannter Datentyp.
NVMeDataTypeIdentify
Identifizieren sie den Datentyp. Dies kann entweder "Controllerdaten identifizieren" oder "Namespacedaten identifizieren" sein. Wenn diese Art von Daten abgefragt wird, verfügt das ProtokollDataRequestValue-Feld STORAGE_PROTOCOL_SPECIFIC_DATA über einen Wert von NVME_IDENTIFY_CNS_CONTROLLER für Adapter oder NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE für Namespace. Wenn die ProtocolDataRequestValue NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE ist, weist das ProtokollDataRequestSubValue-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 in den 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 STORAGE_PROTOCOL_SPECIFIC_DATA Struktur enthält.
  • Legen Sie das PropertyID-Feld auf StorageAdapterProtocolSpecificProperty oder StorageDeviceProtocolSpecificProperty für einen Controller oder einen Device/Namespace-Anforderung fest.
  • Legen Sie das QueryType-Feld auf PropertyStandardQuery fest.
  • Füllen Sie die STORAGE_PROTOCOL_SPECIFIC_DATA Struktur mit den gewünschten Werten aus. Der Anfang des STORAGE_PROTOCOL_SPECIFIC_DATA ist das Feld "AdditionalParameters " von STORAGE_PROPERTY_QUERY.

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

  • Legen Sie das ProtokollType-Feld 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 von Controllerdaten 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]
Header winioctl.h (enthalten Windows.h)

Weitere Informationen