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는 다음 상태 코드 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
EventBufferLength 는 EVENT_BUFFER_MAX_LENGTH 보다 큽다. |
|
매개 변수 중 하나에 대한 포인터는 NULL이거나 이벤트 구조의 EventBufferLength/EventBuffer가 일치하지 않습니다. |
|
이 함수는 활성 운영 체제에서 구현되지 않습니다. |
|
원격 분석 이벤트 데이터가 성공적으로 기록되었습니다. |
설명
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 | 모두 |