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 ocorre um dos seguintes eventos:
- 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 Informações 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 da solicitação:
STATUS_INVALID_PARAMETER
O valor de contagem especificado para a solicitação de contador XOFF é menor que zero.
STATUS_SERIAL_COUNTER_TIMEOUT
Tempo limite da solicitação excedido.
STATUS_SERIAL_MORE_WRITES
Uma solicitação de gravação foi recebida.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddser.h (inclua Ntddser.h) |