StorPortEtwLogByteStream 함수(storport.h)

아티클
08/07/2023

StorPortEtwLogByteStream 은 지정된 채널에 범용 바이트 스트림 매개 변수를 사용하여 ETW(Windows용 이벤트 추적) 이벤트를 기록합니다.

구문

ULONG StorPortEtwLogByteStream(
  [in]           PVOID                      HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS              Address,
  [in]           STORPORT_ETW_EVENT_CHANNEL EventChannel,
  [in]           ULONG                      EventId,
  [in]           PWSTR                      EventDescription,
  [in]           ULONGLONG                  EventKeywords,
  [in]           STORPORT_ETW_LEVEL         EventLevel,
  [in]           STORPORT_ETW_EVENT_OPCODE  EventOpcode,
  [in]           USHORT                     DataLength,
  [in]           PUCHAR                     Data
);

매개 변수

[in] HwDeviceExtension

미니포트의 디바이스 확장에 대한 포인터입니다.

[in, optional] Address

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

[in] EventChannel

이벤트를 기록할 ETW 채널을 식별하는 STORPORT_ETW_EVENT_CHANNEL 값입니다.

[in] EventId

이벤트를 고유하게 식별하는 미니포트 정의 이벤트 ID입니다.

[in] EventDescription

이벤트를 설명하는 짧은 문자열입니다. EventDescription 은 필수이며 NULL 종결자를 포함하지 않고 = STORPORT_ETW_MAX_DESCRIPTION_LENGTH 문자여야 <합니다.

[in] EventKeywords

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

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

[in] EventLevel

이벤트 수준입니다. 이 값은 이벤트의 중요도 또는 심각도를 나타낼 수 있습니다. 다음 값 중 하나입니다.

값	의미
StorportEtwLevelLogAlways	이벤트를 무조건 기록합니다. 이벤트는 설정된 필터에 관계없이 기록됩니다.
StorportEtwLevelCritical	위험 수준 이벤트입니다.
StorportEtwLevelError	오류 수준 이벤트입니다.
StorportEtwLevelWarning	경고 수준 이벤트입니다.
StorportEtwLevelInformational	정보 이벤트입니다.
StorportEtwLevelVerbose	제공된 자세한 이벤트 정보입니다.

[in] EventOpcode

이벤트의 작동 특성입니다. 다음 값 중 하나입니다.

값	의미
StorportEtwEventOpcodeInfo	일반 정보 이벤트입니다.
StorportEtwEventOpcodeStart	디바이스 또는 단위가 시작되었습니다.
StorportEtwEventOpcodeStop	장치 또는 장치가 중지되었습니다. 이벤트는 마지막 페어링되지 않은 시작 이벤트에 해당합니다.
StorportEtwEventOpcodeDC_Start	데이터 수집 시작 이벤트입니다. 런다운 이벤트 유형입니다.
StorportEtwEventOpcodeDC_Stop	데이터 수집 중지 이벤트입니다. 런다운 이벤트 유형입니다.
StorportEtwEventOpcodeExtension	확장 이벤트입니다.
StorportEtwEventOpcodeReply	회신 이벤트입니다.
StorportEtwEventOpcodeResume	일시 중단 후 디바이스 또는 단위가 다시 초기화되었습니다.
StorportEtwEventOpcodeSuspend	다른 작업이 완료될 때까지 디바이스 또는 단위가 일시 중단됩니다.
StorportEtwEventOpcodeReceive	활동의 전송은 다른 구성 요소에서 수신됩니다.

[in] DataLength

Data가 가리키는 바이트 스트림의 길이(바이트)입니다. 여기서 1 <= DataLength<= STORPORT_ETW_MAX_BYTE_STREAM_LENGTH.

[in] Data

미니포트의 사용자 지정 ETW 바이트 스트림에 대한 포인터입니다.

반환 값

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

반환 코드	설명
STOR_STATUS_SUCCESS	지정된 ETW 채널에 이벤트가 성공적으로 기록되었습니다.
STOR_STATUS_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 예를 들어 HwDeviceExtension, EventDescription 또는 Data 는 NULL이고 DataLength 는 최대 이름 길이보다 크고 EventChannel 은 잘못된 값입니다.
STOR_STATUS_UNSUCCESSFUL	다른 내부 이유로 반환됩니다.

설명

미니포트는 StorPortEtwLogByteStream 을 호출하여 범용 바이트 스트림 매개 변수를 사용하여 ETW 이벤트를 특정 채널에 기록할 수 있습니다.

StorPortEtwLogByteStream은 미니포트가 StorPortEtwEvent2, StorPortEtwEvent4 또는 StorPortEtwEvent8에서 허용되는 컨텍스트 이상으로 컨텍스트를 기록해야 하는 경우에 유용합니다. instance 경우 미니포트는 내부 데이터 구조를 바이트 스트림으로 기록할 수 있으며, 이 스트림은 문제가 보고될 때 진단 목적으로 사용할 수 있습니다.