IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)
Mengaktifkan atau menonaktifkan penempatan status baris dan nilai status modem ke dalam aliran data reguler yang diperoleh aplikasi melalui fungsi ReadFile .
Ketika mode penempatan data status baris dan status modem ini diaktifkan, nilai status didahului dalam aliran data oleh karakter escape. Karakter escape yang dapat ditentukan pengguna diatur oleh kode kontrol IOCTL_SERIAL_LSRMST_INSERT . Lihat bagian Keterangan untuk detail nilai status.
Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.
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
);
Keterangan
Catatan
Aplikasi yang menggunakan skema ini harus memeriksa setiap karakter dalam aliran data untuk menentukan keberadaan data status modem atau status baris.
Nilai berikut mengikuti karakter escape yang ditunjuk dalam aliran data jika mode LSRMST_INSERT telah diaktifkan.
Nilai | Makna |
---|---|
SERIAL_LSRMST_ESCAPE | Menunjukkan penerimaan karakter escape itu sendiri ke dalam aliran data. |
SERIAL_LSRMST_LSR_DATA | Menunjukkan bahwa perubahan status baris terjadi, dan data tersedia di buffer perangkat keras penerima. Mengikuti BYTE ini adalah nilai BYTE dari daftar status baris adalah BYTE yang ada di buffer perangkat keras penerima ketika perubahan status baris diproses. |
SERIAL_LSRMST_LSR_NODATA | Menunjukkan bahwa perubahan status baris terjadi, tetapi tidak ada data yang tersedia di buffer perangkat keras penerima. |
SERIAL_LSRMST_MST | Menunjukkan bahwa terjadi perubahan status modem. Mengikuti BYTE ini adalah BYTE yang merupakan nilai daftar status modem ketika perubahan status modem diproses. |
Persyaratan
Klien minimum yang didukung | Windows XP |
Server minimum yang didukung | Windows Server 2003 |
Header | winioctl.h (termasuk Windows.h) |