RxLogEventWithBufferDirect 関数 (rxprocs.h)

[アーティクル]
02/29/2024

RxLogEventWithBufferDirect は、I/O エラーログ構造を割り当て、情報を入力して、エントリを I/O エラーログに書き込みます。

構文

void RxLogEventWithBufferDirect(
       IN PVOID           DeviceOrDriverObject,
  [in] IN PUNICODE_STRING OriginatorId,
  [in] IN ULONG           EventId,
  [in] IN NTSTATUS        Status,
  [in] IN PVOID           DataBuffer,
  [in] IN USHORT          DataBufferLength,
  [in] IN ULONG           LineNumber
);

パラメーター

DeviceOrDriverObject

RDBSS デバイスオブジェクトへのポインター。

[in] OriginatorId

エラーを生成する呼び出し元を示す文字列。

[in] EventId

ルーチンによって返される NTSTATUS 値とは異なる入出力エラー・ログ・コードを示す値。有効な I/O エラーログコード値は、Microsoft Windows SDKと Visual Studio に含まれる ntiolog.h ヘッダーファイルで定義されています。

[in] Status

エラーを示すルーチンの状態コードを示す値。

[in] DataBuffer

I/O エラーログ構造に追加されるデータバッファーへのポインター。

[in] DataBufferLength

I/O エラーログ構造に追加するデータバッファーの長さ。

[in] LineNumber

このエラーが発生したソースコードファイルの行番号。

戻り値

なし

解説

RxLogEventDirect は 内部的に RxLogEventWithAnnotation ルーチンを呼び出して、 Status パラメーターと LineNumber パラメーターを Annotations パラメーターとして RxLogEventWithAnnotation に渡すログエントリを作成および書き込みます。

I/O エラー・ログ・エントリー・サイズは、255 文字の長さに制限されています。そのため、 EventId、 DataBuffer、 Annotations パラメーターの合計長に I/O エラーログエントリの固定部分のサイズが 255 を超える場合、I/O エラーログエントリは作成されません。

RxLogEventWithAnnotation ルーチンは、I/O エラーログエントリを作成するためにメモリを割り当てる必要があります。その結果、メモリ割り当てが失敗した場合、 RxLogEventWithBufferDirect はサイレントモードで失敗する可能性があります。