RxLogEventWithAnnotation, fonction (rxprocs.h)

  • Article

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 qui est 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 Microsoft Windows SDK et Visual Studio.

Status

Valeur indiquant le code status d’une routine indiquant un échec.

DataBuffer

Pointeur vers une mémoire tampon de données brutes à 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

None

Remarques

Un mini-redirecteur réseau appelle RxLogEventWithAnnotation pour enregistrer 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 des paramètres Id, RawDataBuffer et Annotations , plus la taille de la partie fixe de l’entrée du journal des erreurs d’E/S dépasse 255, RxLogEventWithAnnotation échoue en mode silencieux et aucune entrée de 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.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxprocs.h (inclure Rxprocs.h, Rxstruc.h)
IRQL <= APC_LEVEL

Voir aussi

RxLogEventDirect

RxLogEventWithBufferDirect

_RxLog