IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)

  • Articolo

La richiesta IOCTL_SERIAL_XOFF_COUNTER imposta un contatore XOFF. Una richiesta di contatore XOFF supporta i client che usano software per emulare il controllo del flusso di handshake hardware.

Una richiesta di contatore XOFF viene sincronizzata con le richieste di scrittura. Il driver invia un carattere XOFF specificato e completa la richiesta dopo uno degli eventi seguenti:

  • Viene ricevuta una richiesta di scrittura.
  • Un timer scade (un valore di timeout viene specificato dalla richiesta di contatore XOFF).
  • Il driver del controller seriale riceve un numero di caratteri maggiore o uguale a un conteggio specificato dalla richiesta del contatore XOFF.
Per altre informazioni sull'operazione di un contatore XOFF, vedere la descrizione della struttura SERIAL_XOFF_COUNTER nel file di intestazione Ntddser.h in Microsoft Windows Driver Kit (WDK).

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

AssociatedIrp.SystemBuffer punta a una struttura di SERIAL_XOFF_COUNTER allocata dal client usata per immettere informazioni sul contatore XOFF.

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength è impostato sulle dimensioni, in byte, di una struttura SERIAL_XOFF_COUNTER.

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco dello stato

Il membro Informazioni è impostato su zero.

Il membro Status è impostato su uno dei valori di stato generici per le richieste di controllo del dispositivo seriale o su uno dei valori specifici della richiesta seguenti:

STATUS_INVALID_PARAMETER

Il valore di conteggio specificato per la richiesta di contatore XOFF è minore di zero.

STATUS_SERIAL_COUNTER_TIMEOUT

Timeout della richiesta.

STATUS_SERIAL_MORE_WRITES

È stata ricevuta una richiesta di scrittura.

Requisiti

Requisito Valore
Intestazione ntddser.h (include Ntddser.h)

Vedi anche

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON