Compartilhar via


IOCTL_SERIAL_GET_STATS IOCTL (ntddser.h)

A solicitação IOCTL_SERIAL_GET_STATS retorna informações sobre o desempenho de um controlador serial. As estatísticas incluem o número de caracteres transmitidos, o número de caracteres recebidos e estatísticas de erro úteis. O driver incrementa continuamente os valores de desempenho.

Para redefinir os valores de desempenho acumulados para zero, um cliente pode usar uma solicitação IOCTL_SERIAL_CLEAR_STATS .

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

O membro AssociatedIrp.SystemBuffer aponta para uma estrutura de SERIALPERF_STATS alocada pelo cliente que o driver do controlador serial usa para gerar informações de desempenho.

Comprimento do buffer de saída

O membro Parameters.DeviceIoControl.OutputBufferLength é definido como o tamanho, em bytes, de uma estrutura SERIALPERF_STATS .

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS .

Requisitos

Requisito Valor
Cabeçalho ntddser.h (inclua Ntddser.h)

Confira também

IOCTL_SERIAL_CLEAR_STATS

SERIALPERF_STATS