Partager via


IOCTL_SERIAL_GET_STATS IOCTL (ntddser.h)

La requête IOCTL_SERIAL_GET_STATS retourne des informations sur les performances d’un contrôleur série. Les statistiques incluent le nombre de caractères transmis, le nombre de caractères reçus et les statistiques d’erreur utiles. Le pilote incrémente continuellement les valeurs de performances.

Pour réinitialiser les valeurs de performances accumulées à zéro, un client peut utiliser une requête IOCTL_SERIAL_CLEAR_STATS .

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

Le membre AssociatedIrp.SystemBuffer pointe vers une structure de SERIALPERF_STATS allouée par le client que le pilote de contrôleur série utilise pour générer des informations de performances.

Longueur de la mémoire tampon de sortie

Le membre Parameters.DeviceIoControl.OutputBufferLength est défini sur la taille, en octets, d’une structure SERIALPERF_STATS .

Bloc d’état

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Sinon, indiquez la condition d’erreur appropriée en tant que code NTSTATUS .

Configuration requise

Condition requise Valeur
En-tête ntddser.h (inclure Ntddser.h)

Voir aussi

IOCTL_SERIAL_CLEAR_STATS

SERIALPERF_STATS