IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)
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.
Codice principale
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) |