Fungsi RxLogEventDirect (rxprocs.h)

Artikel
03/01/2024

RxLogEventDirect dipanggil untuk mencatat kesalahan ke log kesalahan I/O.

Disarankan agar makro RXLogEvent atau makro RxLogFailure digunakan alih-alih memanggil rutinitas ini secara langsung.

Sintaks

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
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat RDBSS.

[in] OriginatorId

String yang menunjukkan pemanggil yang menghasilkan kesalahan.

[in] EventId

Nilai yang menunjukkan nilai kode log kesalahan I/O yang berbeda dari nilai NTSTATUS yang dikembalikan oleh rutinitas. Nilai kode log kesalahan I/O legal ditentukan dalam file header ntiolog.h yang disertakan dengan Microsoft Windows SDK dan Visual Studio.

[in] Status

Nilai yang menunjukkan kode status rutinitas yang menunjukkan kegagalan.

[in] Line

Nomor baris dalam file kode sumber tempat kegagalan ini terjadi.

Nilai kembali

Tidak ada

Keterangan

RxLogEventDirect secara internal memanggil rutinitas RxLogEventWithAnnotation untuk membuat dan menulis entri log.

Ukuran entri log kesalahan I/O dibatasi hingga panjang 255 karakter. Jadi, jika panjang gabungan OriginatorId ditambah ukuran bagian tetap dari log kesalahan I/O melebihi 255, maka tidak ada entri log kesalahan I/O yang akan dibuat.

Rutinitas RxLogEventWithAnnotation perlu mengalokasikan memori untuk membuat entri log kesalahan I/O . Akibatnya, RxLogEventDirect dapat secara diam-diam gagal jika alokasi memori gagal.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	rxprocs.h (termasuk Rxprocs.h, Rxstruc.h)
IRQL	<= APC_LEVEL

Lihat juga

RxLogEventWithAnnotation

RxLogEventWithBufferDirect

_RxLog

Bagikan melalui