StorPortLogTelemetryEx 함수(storport.h)
StorPortLogTelemetry 루틴은 미니포트 원격 분석 이벤트를 기록하여 유용한 정보를 진단하거나 수집하는 데 도움이 됩니다.
구문
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
매개 변수
HwDeviceExtension
HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.
StorAddress
스토리지 단위 디바이스 주소입니다. 이 매개 변수는 어댑터 디바이스의 경우 NULL입니다.
Event
원격 분석 데이터 페이로드를 포함하는 STORPORT_TELEMETRY_EVENT 구조체에 대한 포인터입니다.
Category
STOR_TELEMETRY_CATEGORY 기록할 원격 분석의 범주를 지정하는 열거형 값입니다.
반환 값
StorPortLogTelemetryEx는 다음 상태 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | 이벤트->EventBufferLength 는 EVENT_BUFFER_MAX_LENGTH보다 큽 있습니다. |
| STOR_STATUS_INVALID_PARAMETER | 매개 변수 중 하나에 대한 포인터가 NULL이거나 NULL이 아닌 Event-EventBuffer>에 대해 EventBufferLength가 0으로 설정됩니다. |
| STOR_STATUS_NOT_IMPLEMENTED | 이 함수는 활성 운영 체제에서 구현되지 않습니다. |
| STOR_STATUS_SUCCESS | 원격 분석 이벤트가 성공적으로 기록되었습니다. |
설명
미니포트는 StorPortLogTelemetryEx 를 호출하여 미니포트 사용자 지정 데이터로 추적 로깅 측정값 또는 원격 분석 이벤트를 기록할 수 있습니다. 미니포트는 범주에 이벤트 범주 유형을 지정합니다.
이벤트 데이터는 Event가 가리키는STORPORT_TELEMETRY_EVENT 구조에 캡슐화됩니다. 미니포트는 8개의 범용 이름-값 쌍과 최대 길이가 4KB인 버퍼뿐만 아니라 여러 이벤트 관련 필드를 기록할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | storport.h |