StorPortEtwChannelEvent4 함수(storport.h)

아티클
02/07/2025

미니포트는 storPortEtwChannelEvent4 호출하여 4개의 범용 ETW 매개 변수가 있는 ETW 이벤트를 지정된 채널에 기록합니다.

통사론

ULONG StorPortEtwChannelEvent4(
  PVOID                                                        HwDeviceExtension,
  PSTOR_ADDRESS                                                Address,
  STORPORT_ETW_EVENT_CHANNEL                                   EventChannel,
  ULONG                                                        EventId,
  PWSTR                                                        EventDescription,
  ULONGLONG                                                    EventKeywords,
  STORPORT_ETW_LEVEL                                           EventLevel,
  STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  PSCSI_REQUEST_BLOCK                                          Srb,
  _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
);

매개 변수

HwDeviceExtension

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

Address

[in/optional] 스토리지 단위 디바이스 주소입니다. 이 매개 변수는 어댑터 디바이스의 경우 NULL입니다.

EventChannel

[in] 이벤트를 기록할 Storport 채널을 지정하는 STORPORT_ETW_EVENT_CHANNEL 값입니다.

EventId

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

EventDescription

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

EventKeywords

[in] 이벤트 분류에 대한 키워드 플래그입니다. 원하는 키워드가 없으면 0으로 설정합니다. 키워드는 다음의 비트 OR 조합입니다.

값	의미
STORPORT_ETW_EVENT_KEYWORD_IO	이 이벤트는 디바이스 IO 작업과 관련이 있습니다.
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	이 이벤트는 성능과 관련이 있습니다.
STORPORT_ETW_EVENT_KEYWORD_POWER	이 이벤트는 디바이스 전원과 관련이 있습니다.
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	이 이벤트는 디바이스 열거와 관련이 있습니다.

EventLevel

[in] 이벤트의 중요도 또는 심각도를 지정하는 STORPORT_ETW_LEVEL 값입니다.

EventOpcode

[in] 이벤트의 작동 특성을 지정하는 STORPORT_ETW_EVENT_OPCODE 값입니다.

Srb

[in] 기록된 이벤트와 연결된 SRB에 대한 포인터입니다. 이 매개 변수에 유효한 SRB가 포함된 경우 이 SRB 포인터와 연결된 SRB 포인터가 기록됩니다.

Parameter1Name

[in] Parameter1Value의미에 대한 설명입니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter1Value

[in] 매개 변수 1의 값입니다.

Parameter2Name

[in] Parameter2Value의미에 대한 설명입니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter2Value

[in] 매개 변수 2의 값입니다.

Parameter3Name

[in] Parameter3Value의미에 대한 설명입니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter3Value

[in] 매개 변수 3의 값입니다.

Parameter4Name

[in] Parameter4Value의미에 대한 설명입니다. 문자열의 최대 크기는 null 종결자를 포함하지 않고 STORPORT_ETW_MAX_PARAM_NAME_LENGTH 문자입니다.

Parameter4Value

[in] 매개 변수 4의 값입니다.

반환 값

StorPortEtwChannelEvent4 다음 상태 코드 중 하나를 반환합니다.

반환 코드	묘사
STOR_STATUS_SUCCESS	이벤트가 성공적으로 기록되었습니다.
STOR_STATUS_NOT_IMPLEMENTED	스토리지 이벤트에는 추적을 사용할 수 없습니다.
STOR_STATUS_INVALID_PARAMETER	매개 변수 중 하나가 잘못되었습니다. 예를 들어 HwDeviceExtension 또는 EventDescription NULL이거나, eventDescription 최대 이름 길이보다 크거나, ETW 매개 변수 이름이 최대 이름 길이보다 큽니다.

발언

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

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