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 Statistik enthält die Anzahl der übertragenen Zeichen, die Anzahl der empfangenen Zeichen und nützliche Fehlerstatistiken. Der Treiber erhöht kontinuierlich Leistungswerte.

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

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts.

Eingabepufferlänge

Nichts.

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

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

Statusblock

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

Anforderungen

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

Siehe auch

IOCTL_SERIAL_CLEAR_STATS

SERIALPERF_STATS