RxLogEventWithAnnotation 関数 (rxprocs.h)

[アーティクル]
02/26/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 エラーログコード値は、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 はサイレントモードで失敗する可能性があります。