IOCTL_SERIAL_LSRMST_INSERT IOCTL (ntddser.h)
Permintaan IOCTL_SERIAL_LSRMST_INSERT memungkinkan atau menonaktifkan penyisipan informasi tentang status baris dan status modem di aliran data penerima. Jika penyisipan LSRMST diaktifkan, driver menyisipkan informasi peristiwa untuk jenis peristiwa yang didukung. Informasi peristiwa menyertakan header peristiwa diikuti oleh data khusus peristiwa.
Header peristiwa berisi karakter escape yang ditentukan klien dan konstanta SERIAL_LSRMST_XXX yang menunjukkan jenis peristiwa. Driver mendukung jenis peristiwa berikut:
- SERIAL_LSRMST_LSR_DATA
- Perubahan terjadi dalam status baris. Driver pengontrol serial menyisipkan header peristiwa diikuti oleh data khusus peristiwa, yang merupakan nilai daftar status baris diikuti oleh karakter yang ada di perangkat keras penerima ketika perubahan status baris diproses.
- SERIAL_LSRMST_LSR_NODATA
- Terjadi perubahan status baris, tetapi tidak ada data yang tersedia di buffer penerima. Driver pengontrol serial menyisipkan header peristiwa diikuti oleh data khusus peristiwa, yang merupakan nilai daftar status baris saat perubahan status baris diproses.
- SERIAL_LSRMST_MST
- Perubahan terjadi dalam status modem. Driver pengontrol serial menyisipkan header peristiwa diikuti oleh data khusus peristiwa, yang merupakan nilai daftar status modem ketika perubahan status modem diproses.
- SERIAL_LSRMST_ESCAPE
- Menunjukkan bahwa karakter berikutnya dalam aliran data penerima, yang diterima dari perangkat, identik dengan karakter escape yang ditentukan klien. Driver pengontrol serial menyisipkan header kejadian. Tidak ada data khusus peristiwa.
Kode utama
Buffer input
Anggota AssociatedIrp.SystemBuffer menunjuk ke nilai input UCHAR yang dialokasikan klien untuk digunakan sebagai karakter escape. Jika karakter escape bukan nol, penyisipan diaktifkan, dan driver serial menggunakan karakter escape yang ditentukan. Jika tidak, penyisipan dinonaktifkan.
Panjang buffer input
Anggota Parameters.DeviceIoControl.InputBufferLength diatur ke ukuran, dalam byte, dari UCHAR.
Buffer output
Tidak ada.
Panjang buffer output
Tidak ada.
Blok status
Jika permintaan berhasil, anggota Informasi diatur ke ukuran, dalam byte, dari UCHAR. Jika tidak, Informasi diatur ke nol.
Anggota Status diatur ke salah satu Nilai Status Generik untuk Permintaan Kontrol Perangkat Serial. Status STATUS_INVALID_PARAMETER menunjukkan bahwa karakter escape yang ditentukan sama dengan karakter XON (transmit on) atau XOFF (transmit off), atau bahwa penggantian kesalahan diaktifkan dengan kontrol alur jabat tangan.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | ntddser.h (termasuk Ntddser.h) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk