IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

  • Artikel

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)

Lihat juga