StorPortLogTelemetry 함수(storport.h)

StorPortLogTelemetry 루틴은 미니포트 원격 분석 이벤트를 기록하여 유용한 정보를 진단하거나 수집하는 데 도움이 됩니다. 미니포트는 8개의 범용 이름-값 쌍과 최대 길이가 4KB인 버퍼뿐만 아니라 구조 STORPORT_TELEMETRY_EVENT 정의된 여러 이벤트 관련 필드를 기록할 수 있습니다.

구문

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

매개 변수

[in] HwDeviceExtension

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

[in, optional] StorAddress

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

[in] Event

원격 분석 데이터 페이로드를 포함하는 STORPORT_TELEMETRY_EVENT 구조체에 대한 포인터입니다.

반환 값

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

반환 코드 설명
STOR_STATUS_INVALID_BUFFER_SIZE
EventBufferLengthEVENT_BUFFER_MAX_LENGTH 보다 큽다.
STOR_STATUS_INVALID_PARAMETER
매개 변수 중 하나에 대한 포인터는 NULL이거나 이벤트 구조의 EventBufferLength/EventBuffer가 일치하지 않습니다.
STOR_STATUS_NOT_IMPLEMENTED
이 함수는 활성 운영 체제에서 구현되지 않습니다.
STATUS_SUCCESS
원격 분석 이벤트 데이터가 성공적으로 기록되었습니다.

설명

Event 구조의 매개 변수 이름이 Event-ParameterNameX> == NULL이 아닌 경우 루틴은 해당 매개 변수 값을 0으로 설정합니다.

miniport에 Event-EventBuffer를 채울 페이로드가 없는 경우 Event-EventBufferLength>> = 0뿐만 아니라 Event-EventBuffer> = NULL을 설정해야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10, 버전 1703
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 storport.h(Storport.h 포함)
IRQL 모두

추가 정보

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx