StorPortEtwLogError 함수(storport.h)

아티클
08/07/2023

StorPortEtwLogError 는 하드웨어 프로토콜 오류에 대한 ETW(Windows용 이벤트 추적) 이벤트를 기록합니다.

구문

ULONG StorPortEtwLogError(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Id,
  [in]           PWSTR         Description,
  [in]           ULONG         DataBufferLength,
  [in]           PVOID         DataBuffer
);

매개 변수

[in] HwDeviceExtension

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

[in, optional] Address

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

[in] Id

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

[in] Description

오류에 대한 설명 텍스트입니다. 이 매개 변수는 필수입니다.

[in] DataBufferLength

DataBuffer의 크기(바이트)입니다.

[in] DataBuffer

오류의 원인을 식별하는 데 유용한 드라이버별 이진 데이터를 포함하는 가변 크기 버퍼입니다. 드라이버는 DataBufferLength 매개 변수에서 이 버퍼의 크기를 지정해야 합니다.

반환 값

이 함수는 다음 상태 코드 중 하나를 반환합니다.

반환 코드	설명
STOR_STATUS_SUCCESS	이벤트가 성공적으로 기록되었습니다.
STOR_STATUS_INVALID_PARAMETER	설명 또는 DataBuffer 가 NULL이거나 DataBufferLength 가 0보다 크지 않습니다.
STOR_STATUS_UNSUCCESSFUL	STORPort가 ETW 로깅을 사용할 수 없는 등의 다른 이유로 ETW 이벤트를 기록할 수 없습니다.

설명

미니포트는 StorPortEtwLogError 를 호출하여 하드웨어 프로토콜 오류에 대한 ETW 이벤트를 기록할 수 있습니다. 이 함수에서 생성된 이벤트는 "Microsoft-Windows-Storage-Storport/Operational" ETW 채널에 게시됩니다.