Partager via

IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

  • Article

Active ou désactive le placement des valeurs de status de status de ligne et de modem dans le flux de données normal qu’une application acquiert via la fonction ReadFile.

Lorsque ce mode de placement de données status ligne et modem-status est activé, status valeurs sont précédées dans le flux de données d’un caractère d’échappement. Le caractère d’échappement définissable par l’utilisateur est défini par le code de contrôle IOCTL_SERIAL_LSRMST_INSERT . Pour plus d’informations sur status valeur, consultez la section Remarques.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Notes

Une application qui utilise ce schéma doit examiner chaque caractère du flux de données pour déterminer la présence de données status modem ou status ligne.

Les valeurs suivantes suivent le caractère d’échappement désigné dans le flux de données si le mode LSRMST_INSERT a été activé.

Valeur Signification
SERIAL_LSRMST_ESCAPE Indique la réception du caractère d’échappement lui-même dans le flux de données.
SERIAL_LSRMST_LSR_DATA Indique qu’une ligne status modification s’est produite et que les données étaient disponibles dans la mémoire tampon matérielle de réception. Suivant ce BYTE est une valeur BYTE de la ligne status registre est le BYTE présent dans la mémoire tampon matérielle de réception lorsque la ligne status modification a été traitée.
SERIAL_LSRMST_LSR_NODATA Indique qu’une ligne status modification s’est produite, mais qu’aucune donnée n’était disponible dans la mémoire tampon matérielle de réception.
SERIAL_LSRMST_MST Indique qu’un modem status modification s’est produite. Suivant ce BYTE est un BYTE qui est la valeur du modem status inscrire lorsque le modem status modification a été traité.

Configuration requise

   
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
En-tête winioctl.h (inclure Windows.h)

Voir aussi