Compartilhar via

IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)

  • Artigo

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.
Para obter mais informações sobre a operação de um contador XOFF, consulte a descrição da estrutura SERIAL_XOFF_COUNTER no arquivo de cabeçalho Ntddser.h no WDK (Microsoft Windows Driver Kit).

Código principal

IRP_MJ_DEVICE_CONTROL

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)

Confira também

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON