IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

Habilita o deshabilita la colocación de los valores de estado de línea y estado del módem en el flujo de datos normal que adquiere una aplicación a través de la función ReadFile .

Cuando se habilita este modo de colocación de datos de estado de línea y estado de módem, los valores de estado van precedidos del flujo de datos por un carácter de escape. El carácter de escape que se puede definir por el usuario se establece mediante el código de control IOCTL_SERIAL_LSRMST_INSERT . Consulte la sección Comentarios para obtener los detalles del valor de estado.

Para realizar esta operación, llame a la función DeviceIoControl con los siguientes parámetros.

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

Comentarios

Nota

Una aplicación que use este esquema debe examinar cada carácter del flujo de datos para determinar la presencia de datos de estado de módem o de estado de línea.

Los siguientes valores siguen el carácter de escape designado en el flujo de datos si se ha activado el modo de LSRMST_INSERT .

Valor	Significado
SERIAL_LSRMST_ESCAPE	Indica la recepción del propio carácter de escape en el flujo de datos.
SERIAL_LSRMST_LSR_DATA	Indica que se ha producido un cambio de estado de línea y que los datos están disponibles en el búfer de hardware de recepción. Después de este BYTE , un valor BYTE del registro de estado de línea es el BYTE presente en el búfer de hardware de recepción cuando se procesó el cambio de estado de línea.
SERIAL_LSRMST_LSR_NODATA	Indica que se ha producido un cambio de estado de línea, pero no hay datos disponibles en el búfer de hardware de recepción.
SERIAL_LSRMST_MST	Indica que se ha producido un cambio de estado del módem. Después de este BYTE es un BYTE que es el valor del registro de estado del módem cuando se procesó el cambio de estado del módem.

Requisitos

Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Encabezado	winioctl.h (incluye Windows.h)

Consulte también

• DeviceIoControl