Condividi tramite

IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

  • Articolo

Abilita o disabilita la posizione dei valori di stato della riga e del modem nel flusso di dati normale acquisito da un'applicazione tramite la funzione ReadFile .

Quando questa modalità di posizionamento dei dati di stato della riga e del modem è abilitata, i valori di stato sono preceduti dal flusso di dati da un carattere di escape. Il carattere di escape definito dall'utente viene impostato dal codice di controllo IOCTL_SERIAL_LSRMST_INSERT . Per informazioni dettagliate sul valore di stato, vedere la sezione Osservazioni.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to device
  IOCTL_SERIAL_LSRMST_INSERT,   // dwIoControlCode
  (LPVOID) lpInBuffer,          // input buffer 
  (DWORD) nInBufferSize,        // size of input buffer 
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Commenti

Nota

Un'applicazione che utilizza questo schema deve esaminare ogni carattere nel flusso di dati per determinare la presenza di dati relativi allo stato del modem o allo stato della riga.

I valori seguenti seguono il carattere di escape designato nel flusso di dati se la modalità di LSRMST_INSERT è stata attivata.

Valore Significato
SERIAL_LSRMST_ESCAPE Indica la ricezione del carattere di escape stesso nel flusso di dati.
SERIAL_LSRMST_LSR_DATA Indica che si è verificata una modifica dello stato della riga e che i dati sono stati disponibili nel buffer hardware di ricezione. Dopo questo byte è un valore BYTE del registro di stato della riga è il BYTE presente nel buffer hardware di ricezione quando è stata elaborata la modifica dello stato della riga.
SERIAL_LSRMST_LSR_NODATA Indica che si è verificata una modifica dello stato della riga, ma nel buffer hardware di ricezione non sono disponibili dati.
SERIAL_LSRMST_MST Indica che si è verificata una modifica dello stato del modem. Dopo questo BYTE è un BYTE che è il valore del registro di stato del modem quando è stata elaborata la modifica dello stato del modem.

Requisiti

   
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Intestazione winioctl.h (include Windows.h)

Vedi anche