RxLogEventWithBufferDirect 関数 (rxprocs.h)

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 はサイレントモードで失敗する可能性があります。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	rxprocs.h (Rxprocs.h、Rxstruc.h を含む)
IRQL	<= APC_LEVEL

こちらもご覧ください

RxLogEventDirect

RxLogEventWithAnnotation

_RxLog