RxLogEventDirect 関数 (rxprocs.h)

RxLogEventDirect I/O エラー ログにエラーを記録するために呼び出されます。

このルーチンを直接呼び出す代わりに、RXLogEvent マクロまたは RxLogFailure マクロを使用することをお勧めします。

構文

VOID RxLogEventDirect(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
  [in] IN PUNICODE_STRING      OriginatorId,
  [in] IN ULONG                EventId,
  [in] IN NTSTATUS             Status,
  [in] IN ULONG                Line
);

パラメーター

[in] DeviceObject

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

[in] OriginatorId

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

[in] EventId

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

[in] Status

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

[in] Line

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

戻り値

何一つ

備考

RxLogEventDirect 内部で RxLogEventWithAnnotation ルーチンを呼び出して、ログ エントリを作成および書き込みます。

I/O エラー・ログ項目サイズは、255 文字の長さに制限されています。 したがって、OriginatorId の合計長と I/O エラー ログの固定部分のサイズが 255 を超える場合、I/O エラー ログ エントリは作成されません。

RxLogEventWithAnnotation ルーチンは、I/O エラー ログ エントリを作成するためにメモリを割り当てる必要があります。 その結果、RxLogEventDirect は、メモリ割り当てが失敗すると自動的に失敗する可能性があります。

必要条件

関連項目

RxLogEventWithAnnotation の

RxLogEventWithBufferDirect の

_RxLog