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