RxLogEventWithAnnotation 함수(rxprocs.h)

아티클
03/01/2024

RxLogEventWithAnnotation 은 I/O 오류 로그 구조를 할당하고, 정보를 입력하고, 항목을 I/O 오류 로그에 씁니다.

구문

void RxLogEventWithAnnotation(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
       IN ULONG                EventId,
       IN NTSTATUS             Status,
       IN PVOID                DataBuffer,
       IN USHORT               DataBufferLength,
       IN PUNICODE_STRING      Annotation,
  [in] IN ULONG                AnnotationCount
);

매개 변수

[in] DeviceObject

RDBSS 디바이스 개체에 대한 포인터입니다.

EventId

루틴에서 반환된 NTSTATUS 값과 다른 I/O 오류 로그 코드를 나타내는 값입니다. 법적 I/O 오류 로그 코드 값은 Microsoft Windows SDK 및 Visual Studio에 포함된 ntiolog.h 헤더 파일에 정의됩니다.

Status

오류를 나타내는 루틴의 상태 코드를 나타내는 값입니다.

DataBuffer

I/O 오류 로그 구조에 추가할 원시 데이터 버퍼에 대한 포인터입니다.

DataBufferLength

I/O 오류 로그 구조에 추가할 원시 데이터 버퍼의 길이입니다.

Annotation

I/O 오류 로그 구조에 추가할 주석 문자열에 대한 포인터입니다.

[in] AnnotationCount

I/O 오류 로그 구조에 추가할 주석 문자열 수입니다.

반환 값

없음

설명

네트워크 미니 리다이렉터에서 RxLogEventWithAnnotation 을 호출하여 I/O 오류를 기록합니다.

I/O 오류 로그 항목 크기는 255자로 제한됩니다. 따라서 ID, RawDataBuffer 및 Annotations 매개 변수의 결합된 길이와 I/O 오류 로그 항목의 고정 부분 크기가 255를 초과하면 RxLogEventWithAnnotation 이 자동으로 실패하고 I/O 오류 로그 항목이 생성되지 않습니다.

RxLogEventWithAnnotation 루틴은 I/O 오류 로그 항목을 만들기 위해 메모리를 할당해야 합니다. 따라서 메모리 할당이 실패하면 RxLogEventWithAnnotation 이 자동으로 실패할 수 있습니다.