RxLogEventWithAnnotation, fonction (rxprocs.h)
RxLogEventWithAnnotation alloue une structure de journal des erreurs d’E/S, la remplit avec des informations et écrit l’entrée dans le journal des erreurs d’E/S.
Syntaxe
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
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil RDBSS.
EventId
Valeur indiquant le code du journal des erreurs d’E/S différent d’une valeur NTSTATUS retournée par une routine. Les valeurs de code du journal des erreurs d’E/S légales sont définies dans le fichier d’en-tête ntiolog.h inclus avec le Kit de développement logiciel (SDK) Microsoft Windows et Visual Studio.
Status
Valeur indiquant le code d’état d’une routine indiquant un échec.
DataBuffer
Pointeur vers une mémoire tampon de données brute à ajouter à la structure du journal des erreurs d’E/S.
DataBufferLength
Longueur de la mémoire tampon de données brutes à ajouter à la structure du journal des erreurs d’E/S.
Annotation
Pointeur vers toutes les chaînes d’annotation à ajouter à la structure du journal des erreurs d’E/S.
[in] AnnotationCount
Nombre de chaînes d’annotation à ajouter à la structure du journal des erreurs d’E/S.
Valeur de retour
Aucun
Remarques
Un mini-redirecteur réseau appelle RxLogEventWithAnnotation pour consigner une erreur d’E/S.
La taille d’entrée du journal des erreurs d’E/S est limitée à une longueur de 255 caractères. Par conséquent, si la longueur combinée de l’ID de , RawDataBufferet paramètres annotations, plus la taille de l’entrée du journal des erreurs d’E/S dépasse 255, puis RxLogEventWithAnnotation échoue en mode silencieux et aucune entrée du journal des erreurs d’E/S n’est créée.
La routine RxLogEventWithAnnotation doit allouer de la mémoire pour créer l’entrée du journal des erreurs d’E/S. Par conséquent, RxLogEventWithAnnotation peut échouer en mode silencieux si l’allocation de mémoire échoue.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | rxprocs.h (include Rxprocs.h, Rxstruc.h) |
| IRQL | <= APC_LEVEL |