IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

Включает или отключает размещение значений состояния строки и состояния модема в обычном потоке данных, который приложение получает с помощью функции ReadFile .

Если этот режим размещения данных состояния строки и модема включен, значения состояния в потоке данных предшествуют escape-символом. Определяемый пользователем escape-символ задается кодом элемента управления IOCTL_SERIAL_LSRMST_INSERT . Сведения о значении состояния см. в разделе Примечания.

Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.

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
);

Комментарии

Примечание

Приложение, использующее эту схему, должно проверять каждый символ в потоке данных, чтобы определить наличие данных состояния модема или состояния строки.

Следующие значения следуют за назначенным escape-символом в потоке данных, если включен режим LSRMST_INSERT .

Значение Значение
SERIAL_LSRMST_ESCAPE Указывает на прием самого escape-символа в поток данных.
SERIAL_LSRMST_LSR_DATA Указывает, что произошло изменение состояния строки и данные были доступны в аппаратном буфере получения. После этого BYTE является значением BYTE , регистр состояния строки — это byTE , присутствующий в аппаратном буфере приема при обработке изменения состояния строки.
SERIAL_LSRMST_LSR_NODATA Указывает, что произошло изменение состояния строки, но данные не были доступны в аппаратном буфере получения.
SERIAL_LSRMST_MST Указывает, что произошло изменение состояния модема. После этого BYTE представляет собой значение BYTE , которое является значением регистра состояния модема при обработке изменения состояния модема.

Требования

   
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел