Bagikan melalui


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

IRP_MJ_DEVICE_CONTROL

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)