StorPortNvmeMiniportEvent 함수(storport.h)

아티클
02/07/2025

NVMe 미니포트 드라이버는 StorPortNvmeMiniportEvent 함수를 호출하여 ETW 이벤트를 최대 8개의 추가 범용 매개 변수가 있는 특정 채널에 기록합니다.

통사론

ULONG StorPortNvmeMiniportEvent(
  PVOID                                                        HwDeviceExtension,
  PVOID                                                        ControllerHandle,
  ULONG                                                        NamespaceId,
  STORPORT_ETW_EVENT_CHANNEL                                   EventChannel,
  ULONG                                                        EventId,
  PWSTR                                                        EventDescription,
  ULONGLONG                                                    EventKeywords,
  STORPORT_ETW_LEVEL                                           EventLevel,
  STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  ULONGLONG                                                    Parameter1Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  ULONGLONG                                                    Parameter2Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
  ULONGLONG                                                    Parameter3Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
  ULONGLONG                                                    Parameter4Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter5Name,
  ULONGLONG                                                    Parameter5Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter6Name,
  ULONGLONG                                                    Parameter6Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter7Name,
  ULONGLONG                                                    Parameter7Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter8Name,
  ULONGLONG                                                    Parameter8Value
);

매개 변수

HwDeviceExtension

[in] HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

ControllerHandle

[in/optional] 패브릭 NVMe(NVMe-oF) 미니포트의 경우 이벤트가 컨트롤러별인 경우 ControllerHandle NVMe 컨트롤러에 대한 Storport의 핸들입니다. 그렇지 않으면 값이 NULL입니다.

NamespaceId

[in] 이벤트가 네임스페이스별인 경우 NamespaceId 네임스페이스 식별자입니다. 그렇지 않으면 0이어야 합니다.

EventChannel

[in] 이벤트가 기록되는 ETW 채널을 지정하는 STORPORT_ETW_EVENT_CHANNEL 열거형 값입니다.

EventId

[in] 이벤트 유형을 고유하게 식별하는 미니 푸르트별 이벤트 식별자입니다.

EventDescription

[in] 이벤트를 설명하는 필수 문자열입니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_DESCRIPTION_LENGTH 문자입니다.

EventKeywords

[in] STORPORT_ETW_EVENT_CHANNEL_XXX의 비트 마스크는 이벤트의 특성을 더 자세히 지정하기 위해 값을. 키워드가 필요하지 않은 경우 0으로 설정합니다.

EventLevel

[in] 이벤트의 수준을 지정하는 STORPORT_ETW_LEVEL 값입니다.

EventOpcode

[in] 이벤트의 opcode를 지정하는 STORPORT_ETW_EVENT_OPCODE 열거형 값입니다.

Parameter1Name

[in] Parameter1Value 의미를 부여하는 짧은 문자열입니다. Parameter1Name NULL이거나 빈 문자열인 경우 Parameter1Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter1Value

[in] 첫 번째 매개 변수의 값입니다. Parameter1Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter2Name

[in] Parameter2Value 의미를 부여하는 짧은 문자열입니다. Parameter2Name NULL이거나 빈 문자열인 경우 Parameter2Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter2Value

[in] 두 번째 매개 변수의 값입니다. Parameter2Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter3Name

[in] Parameter3Value 의미를 부여하는 짧은 문자열입니다. Parameter3Name NULL이거나 빈 문자열인 경우 Parameter3Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter3Value

[in] 세 번째 매개 변수의 값입니다. Parameter3Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter4Name

[in] Parameter4Value 의미를 부여하는 짧은 문자열입니다. Parameter4Name NULL이거나 빈 문자열인 경우 Parameter4Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter4Value

[in] 네 번째 매개 변수의 값입니다. Parameter4Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter5Name

[in] Parameter5Value 의미를 부여하는 짧은 문자열입니다. Parameter5Name NULL이거나 빈 문자열인 경우 Parameter5Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter5Value

[in] 다섯 번째 매개 변수의 값입니다. Parameter5Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter6Name

[in] parameter6Value 의미를 부여하는 짧은 문자열입니다. Parameter6Name NULL이거나 빈 문자열인 경우 Parameter6Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter6Value

[in] 여섯 번째 매개 변수의 값입니다. Parameter6Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter7Name

[in] Parameter7Value 의미를 부여하는 짧은 문자열입니다. Parameter7Name NULL이거나 빈 문자열인 경우 Parameter7Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter7Value

[in] 일곱 번째 매개 변수의 값입니다. Parameter7Name NULL 또는 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

Parameter8Name

[in] Parameter8Value 의미를 부여하는 짧은 문자열입니다. Parameter8Name NULL이거나 빈 문자열인 경우 Parameter8Value 무시됩니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter8Value

[in] 여덟 번째 매개 변수의 값입니다. Parameter8Name NULL이거나 빈 문자열인 경우 Storport는 이 값을 0으로 기록합니다.

반환 값

StorPortNvmeMiniportEvent 이벤트가 성공적으로 기록되면 STOR_STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음과 같은 값을 반환합니다.

반환 코드	묘사
STOR_STATUS_NOT_IMPLEMENTED	이 함수는 활성 운영 체제에서 구현되지 않습니다.
STOR_STATUS_INVALID_PARAMETER	하나 이상의 매개 변수가 잘못된 경우 이 반환 값으로 작업이 실패합니다.
STOR_STATUS_UNSUCCESSFUL	다른 내부 이유로 작업이 실패했습니다.

발언

미니포트는 StorPortNvmeMiniportEvent 호출하여 8개의 범용 ETW 매개 변수를 기록할 수 있습니다. ETW 매개 변수는 8개의 이름-값 쌍으로 표현됩니다. 매개 변수의 이름이 지정되지 않은 경우(매개 변수XName = NULL) 루틴은 해당 매개 변수 값을 0으로 설정합니다.

StorPort 미니포트 드라이버에서 생성된 이벤트는 EventChannel지정된 채널에 기록됩니다.