다음을 통해 공유

STORAGE_PROTOCOL_NVME_DATA_TYPE 열거형(winioctl.h)

  • 아티클

IOCTL_STORAGE_QUERY_PROPERTY 요청 중에 쿼리할 NVMe 프로토콜별 데이터의 형식을 설명합니다.

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;

상수

 
NVMeDataTypeUnknown
값: 0
알 수 없는 데이터 형식입니다.
NVMeDataTypeIdentify
데이터 형식을 식별합니다. 컨트롤러 데이터 식별 또는 네임스페이스 데이터 식별 중 하나일 수 있습니다. 이 형식의 데이터를 쿼리할 때 STORAGE_PROTOCOL_SPECIFIC_DATA ProtocolDataRequestValue 필드에는 어댑터에 대한 NVME_IDENTIFY_CNS_CONTROLLER 값 또는 네임스페이스에 대한 NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE 값이 있습니다. ProtocolDataRequestValue가 NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE 경우 STORAGE_PROTOCOL_SPECIFIC_DATA 구조체의 ProtocolDataRequestSubValue 필드에는 네임스페이스 ID 값이 있습니다.
NVMeDataTypeLogPage
로그 페이지 데이터 형식입니다.
NVMeDataTypeFeature
기능 데이터 형식.

설명

IOCTL_STORAGE_QUERY_PROPERTY 사용하여 STORAGE_PROTOCOL_DATA_DESCRIPTOR 프로토콜 관련 정보를 검색하는 경우 다음과 같이 STORAGE_PROPERTY_QUERY 구조를 구성합니다.

  • STORAGE_PROPERTY_QUERY 및 STORAGE_PROTOCOL_SPECIFIC_DATA 구조를 모두 포함할 수 있는 버퍼를 할당합니다.
  • PropertyID 필드를 각각 컨트롤러 또는 디바이스/네임스페이스 요청에 대한 StorageAdapterProtocolSpecificProperty 또는 StorageDeviceProtocolSpecificProperty로 설정합니다.
  • 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/상태 데이터 포함)를 가져옵니다.
    • NVMeDataTypeFeature를 사용하여 NVMe 드라이브의 기능을 가져옵니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)

추가 정보