IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)
A solicitação IOCTL_SERIAL_XOFF_COUNTER define um contador XOFF . Uma solicitação de contador XOFF dá suporte a clientes que usam software para emular o controle de fluxo de handshake de hardware.
Uma solicitação de contador XOFF é sincronizada com solicitações de gravação. O driver envia um caractere XOFF especificado e conclui a solicitação depois que um dos seguintes eventos ocorre:
- Uma solicitação de gravação é recebida.
- Um temporizador expira (um valor de tempo limite é especificado pela solicitação de contador XOFF).
- O driver do controlador serial recebe um número de caracteres maior ou igual a uma contagem especificada pela solicitação de contador XOFF.
Código principal
Buffer de entrada
O AssociatedIrp.SystemBuffer aponta para uma estrutura de SERIAL_XOFF_COUNTER alocada pelo cliente que é usada para inserir informações do contador XOFF.
Comprimento do buffer de entrada
O Parameters.DeviceIoControl.InputBufferLength é definido como o tamanho, em bytes, de uma estrutura SERIAL_XOFF_COUNTER.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
O membro de Informações do está definido como zero.
O membro status é definido como um dos valores de status genérico para solicitações de controle de dispositivo serial ou para um dos seguintes valores específicos à solicitação:
STATUS_INVALID_PARAMETER
O valor de contagem especificado para a solicitação de contador XOFF é menor que zero.
STATUS_SERIAL_COUNTER_TIMEOUT
A solicitação atingiu o tempo limite.
STATUS_SERIAL_MORE_WRITES
Uma solicitação de gravação foi recebida.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ntddser.h (inclua Ntddser.h) |