피드백

StorPortLogTelemetry 함수(storport.h)

  • 아티클
  • 읽는 데 2분 걸림

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

설명

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

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

요구 사항

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

참고 항목

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx