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 エラー ログ コード値は、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 はサイレントモードで失敗する可能性があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | rxprocs.h (Rxprocs.h、Rxstruc.h を含む) |
| IRQL | <= APC_LEVEL |