IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

  • Artikel

Aktiviert oder deaktiviert die Platzierung von Zeilen-status- und Modem-status-Werten im regulären Datenstrom, den eine Anwendung über die ReadFile-Funktion abruft.

Wenn dieser Status- und Modem-status Datenplatzierungsmodus aktiviert ist, wird status Werten im Datenstrom ein Escapezeichen vorangestellt. Das vom Benutzer definierbare Escapezeichen wird durch den IOCTL_SERIAL_LSRMST_INSERT-Steuerelementcode festgelegt. Details zu status Wert finden Sie im Abschnitt Hinweise.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

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

Hinweise

Hinweis

Eine Anwendung, die dieses Schema verwendet, muss jedes Zeichen im Datenstrom untersuchen, um das Vorhandensein von Modem-status- oder Line-status-Daten zu ermitteln.

Die folgenden Werte folgen dem angegebenen Escapezeichen im Datenstrom, wenn der LSRMST_INSERT Modus aktiviert wurde.

Wert Bedeutung
SERIAL_LSRMST_ESCAPE Gibt den Empfang des Escapezeichens selbst in den Datenstrom an.
SERIAL_LSRMST_LSR_DATA Gibt an, dass eine Zeile status Änderung aufgetreten ist und Daten im Empfangshardwarepuffer verfügbar waren. Nach diesem BYTE ist ein BYTE-Wert der Zeile status Register das BYTE ist, das im Empfangshardwarepuffer vorhanden ist, wenn die Zeile status Änderung verarbeitet wurde.
SERIAL_LSRMST_LSR_NODATA Gibt an, dass eine Zeile status Änderung aufgetreten ist, aber keine Daten im Empfangshardwarepuffer verfügbar waren.
SERIAL_LSRMST_MST Gibt an, dass ein Modem status Änderung aufgetreten ist. Nach diesem BYTE ist ein BYTE, der der Wert des Modems status registrieren, wenn das Modem status Änderung verarbeitet wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen