Fungsi RxLogEventWithAnnotation (rxprocs.h)
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 |