Fungsi RxLogEventWithAnnotation (rxprocs.h)

  • Artikel

RxLogEventWithAnnotation mengalokasikan struktur log kesalahan I/O, mengisinya dengan informasi, dan menulis entri ke log kesalahan I/O.

Sintaks

void RxLogEventWithAnnotation(
  [in] IN PRDBSS_DEVICE_OBJECT DeviceObject,
       IN ULONG                EventId,
       IN NTSTATUS             Status,
       IN PVOID                DataBuffer,
       IN USHORT               DataBufferLength,
       IN PUNICODE_STRING      Annotation,
  [in] IN ULONG                AnnotationCount
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat RDBSS.

EventId

Nilai yang menunjukkan 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.

Status

Nilai yang menunjukkan kode status rutinitas yang menunjukkan kegagalan.

DataBuffer

Penunjuk ke buffer data mentah untuk ditambahkan ke struktur log kesalahan I/O.

DataBufferLength

Panjang buffer data mentah yang akan ditambahkan ke struktur log kesalahan I/O.

Annotation

Penunjuk ke string anotasi apa pun untuk ditambahkan ke struktur log kesalahan I/O.

[in] AnnotationCount

Jumlah string anotasi yang akan ditambahkan ke struktur log kesalahan I/O.

Nilai kembali

Tidak ada

Keterangan

Pengalih mini jaringan akan memanggil RxLogEventWithAnnotation untuk mencatat kesalahan I/O.

Ukuran entri log kesalahan I/O dibatasi hingga panjang 255 karakter. Jadi, jika panjang gabungan parameter Id, RawDataBuffer, dan Anotasi ditambah ukuran bagian tetap dari entri log kesalahan I/O melebihi 255, maka RxLogEventWithAnnotation akan gagal secara diam-diam dan tidak ada entri log kesalahan I/O yang akan dibuat.

Rutinitas RxLogEventWithAnnotation perlu mengalokasikan memori untuk membuat entri log kesalahan I/O . Akibatnya, RxLogEventWithAnnotation dapat 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

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog