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
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) |