STORAGE_PROTOCOL_DATA_DESCRIPTOR 結構 (winioctl.h)

此結構會與 IOCTL_STORAGE_QUERY_PROPERTY 搭配使用，以從記憶體裝置或配接器傳回通訊協定特定數據。 .

語法

typedef struct _STORAGE_PROTOCOL_DATA_DESCRIPTOR {
  DWORD                          Version;
  DWORD                          Size;
  STORAGE_PROTOCOL_SPECIFIC_DATA ProtocolSpecificData;
} STORAGE_PROTOCOL_DATA_DESCRIPTOR, *PSTORAGE_PROTOCOL_DATA_DESCRIPTOR;

成員

Version

這個結構的版本。

Size

描述項的大小總計，包括所有通訊協定數據的空間。

ProtocolSpecificData

型 別為 STORAGE_PROTOCOL_SPECIFIC_DATA 的通訊協定特定數據。

備註

使用 IOCTL_STORAGE_QUERY_PROPERTY 擷取 STORAGE_PROTOCOL_DATA_DESCRIPTOR中的通訊協定特定資訊時，請設定 STORAGE_PROPERTY_QUERY 結構，如下所示：

• 配置可以同時包含 STORAGE_PROPERTY_QUERY 和 STORAGE_PROTOCOL_SPECIFIC_DATA 結構的緩衝區。
• 將 PropertyID 字段分別設定為 Controller 或裝置/命名空間要求的 StorageAdapterProtocolSpectocolSpecificProperty 或 StorageDeviceProtocolProperty 。
• 將 QueryType 字段設定為 PropertyStandardQuery。
• 使用所需的值填入 STORAGE_PROTOCOL_SPECIFIC_DATA 結構。 STORAGE_PROTOCOL_SPECIFIC_DATA的開頭是 STORAGE_PROPERTY_QUERY 的 AdditionalParameters 字段。

若要指定 NVMe 通訊協定特定資訊的類型，請設定 STORAGE_PROTOCOL_SPECIFIC_DATA 結構，如下所示：

• 將 [ ProtocolType ] 字段設定為 ProtocolTypeNVMe。
• 將 DataType 欄位設定為 STORAGE_PROTOCOL_NVME_DATA_TYPE所定義的列舉值：
  • 使用 NVMeDataTypeIdentify 取得識別控制器數據或識別命名空間數據。
  • 使用 NVMeDataTypeLogPage 取得記錄頁 (包括 SMART/health 數據) 。
  • 使用 NVMeDataTypeFeature 取得 NVMe 磁碟驅動器的功能。

若要指定 ATA 通訊協定特定資訊的類型，請設定 STORAGE_PROTOCOL_SPECIFIC_DATA 結構，如下所示：

• 將 [ ProtocolType] 字段設定為 ProtocolTypeAta。
• 將 DataType 欄位設定為 STORAGE_PROTOCOL_ATA_DATA_TYPE所定義的列舉值：
  • 使用 AtaDataTypeIdentify 來識別 ATA 磁碟驅動器。
  • 使用 AtaDataTypeLogPage 從 ATA 磁碟驅動器取得記錄頁。

規格需求

需求	值
最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
標頭	winioctl.h (包含 Windows.h)

另請參閱

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY

STORAGE_PROTOCOL_SPECIFIC_DATA