Freigeben über


IOCTL_SERIAL_GET_STATS IOCTL (ntddser.h)

Die IOCTL_SERIAL_GET_STATS Anforderung gibt Informationen zur Leistung eines seriellen Controllers zurück. Die Statistiken enthalten die Anzahl der übertragenen Zeichen, die Anzahl der empfangenen Zeichen und nützliche Fehlerstatistiken. Der Treiber erhöht kontinuierlich die Leistungswerte.

Um die akkumulierten Leistungswerte auf Null zurückzusetzen, kann ein Client eine IOCTL_SERIAL_CLEAR_STATS Anforderung verwenden.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Länge des Eingabepuffers

Keine.

Ausgabepuffer

Der AssociatedIrp.SystemBuffer-Member verweist auf eine vom Client zugewiesene SERIALPERF_STATS Struktur, die der serielle Controllertreiber zum Ausgeben von Leistungsinformationen verwendet.

Länge des Ausgabepuffers

Das Parameters.DeviceIoControl.OutputBufferLength-Element wird auf die Größe einer SERIALPERF_STATS-Struktur in Bytes festgelegt.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Anforderungen

Anforderung Wert
Header ntddser.h (include Ntddser.h)

Weitere Informationen

IOCTL_SERIAL_CLEAR_STATS

SERIALPERF_STATS