다음을 통해 공유

STORAGE_PROTOCOL_NVME_DATA_TYPE 열거형(ntddstor.h)

  • 아티클

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

Syntax

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

상수

 
NVMeDataTypeUnknown
알 수 없는 데이터 형식입니다.
NVMeDataTypeIdentify
컨트롤러 데이터 식별 또는 네임스페이스 데이터 식별일 수 있는 식별 데이터를 가져옵니다.

이 유형의 데이터를 쿼리할 때 STORAGE_PROTOCOL_SPECIFIC_DATA 구조의 필드에는 다음 값이 있어야 합니다.

- ProtocolDataRequestValue 는 어댑 터 또는 네 임스페이스의 NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE NVME_IDENTIFY_CNS_CONTROLLER.
- ProtocolDataRequestValue 가 NVME_IDENTIFY_CNS_SPECIFIC_NAMESPACE 경우 ProtocolDataRequestSubValue 필드는 네임스페이스 ID를 지정합니다. ( NVME_IDENTIFY_CNS_ACTIVE_NAMESPACES 현재 지원되지 않습니다.)
NVMeDataTypeLogPage
NVMe 로그 페이지를 가져옵니다.

이 유형의 데이터를 쿼리할 때 STORAGE_PROTOCOL_SPECIFIC_DATA 구조의 필드에는 다음 값이 있어야 합니다.

- ProtocolDataRequestValue 는 검색할 로그 페이지의 식별자입니다.
- ProtocolDataRequestSubValue 는 데이터 반환을 시작할 로그 페이지 내 오프셋의 하위 32비트 값입니다.
- ProtocolDataRequestSubValue2 는 데이터 반환을 시작할 로그 페이지 내 오프셋의 상위 32비트 값입니다.
- ProtocolDataRequestSubValue3 은 특정 로그 페이지에 필요한 로그별 식별자입니다.
- ProtocolDataRequestSubValue4 는 로그 페이지를 가져오는 경우 추가 정보를 지정할 수 있는 STORAGE_PROTOCOL_DATA_SUBVALUE_GET_LOG_PAGE 구조체입니다.
NVMeDataTypeFeature
명령으로 검색 - GET FEATURES 또는 SET FEATURES

STORAGE_PROTOCOL_SPECIFIC_DATA(get) 또는 STORAGE_PROTOCOL_SPECIFIC_DATA_EXT(집합)의 해당 값:

- ProtocolDataRequestValue - NVME_CDW10_GET_FEATURES/NVME_CDW10_SET_FEATURES 정의됨
- ProtocolDataRequestSubValue - NVME_CDW11_FEATURES 정의됨
- ProtocolDataRequestSubValue2 - NVME_CDW12_FEATURES 정의됨
- ProtocolDataRequestSubValue3 - NVME_CDW13_FEATURES 정의됨
- ProtocolDataRequestSubValue4 - NVME_CDW14_FEATURES 정의됨
- ProtocolDataRequestSubValue5 - NVME_CDW15_FEATURES 정의됨
NVMeDataTypeLogPageEx
명령으로 검색됨 - GET LOG PAGE

이 유형의 데이터를 쿼리할 때 STORAGE_PROTOCOL_SPECIFIC_DATA_EXT 구조의 필드에는 다음 값이 있어야 합니다.

- ProtocolDataValue - NVME_CDW10_GET_LOG_PAGE 정의됨
- ProtocolDataSubValue - NVME_CDW11_GET_LOG_PAGE 정의됨
- ProtocolDataSubValue2 - NVME_CDW12_GET_LOG_PAGE 정의됨
- ProtocolDataSubValue3 - NVME_CDW13_GET_LOG_PAGE 정의됨
- ProtocolDataSubValue4 - NVME_CDW14_GET_LOG_PAGE 정의됨
- ProtocolDataSubValue5 - NVME_CDW15_GET_LOG_PAGE 정의됨(현재 사용되지 않음)
- ProtocolDataSubValue6 - 네임스페이스 ID
NVMeDataTypeFeatureEx
명령으로 검색 - GET FEATURES 또는 SET FEATURES

이 유형의 데이터를 쿼리할 때 STORAGE_PROTOCOL_SPECIFIC_DATA_EXT 구조의 필드에는 다음 값이 있어야 합니다.

- ProtocolDataValue - NVME_CDW10_GET_FEATURES/NVME_CDW10_SET_FEATURES 정의됨
- ProtocolDataSubValue - NVME_CDW11_FEATURES 정의됨
- ProtocolDataSubValue2 - NVME_CDW12_FEATURES 정의됨
- ProtocolDataSubValue3 - NVME_CDW13_FEATURES 정의됨
- ProtocolDataSubValue4 - NVME_CDW14_FEATURES 정의됨
- ProtocolDataSubValue5 - NVME_CDW15_FEATURES 정의됨
- ProtocolDataSubValue6 - 네임스페이스 ID

설명

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 드라이브의 기능을 가져옵니다.
    • NVMeDataTypeLogPageEx를 사용하여 확장 형식을 사용하여 로그 페이지(SMART/상태 데이터 포함)를 가져옵니다.
    • NVMeDataTypeFeatureEx를 사용하여 확장 형식을 사용하여 NVMe 드라이브의 기능을 가져옵니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
머리글 ntddstor.h(Ntddstor.h 포함)

추가 정보