Compartilhar via

IOCTL_SERIAL_LSRMST_INSERT IOCTL (winioctl.h)

  • Artigo

Habilita ou desabilita o posicionamento de valores de status de linha e modem status no fluxo de dados regular que um aplicativo adquire por meio da função ReadFile.

Quando esse modo de posicionamento de dados status de linha e modem-status está habilitado, status valores são precedidos no fluxo de dados por um caractere de escape. O caractere de escape definível pelo usuário é definido pelo código de controle IOCTL_SERIAL_LSRMST_INSERT . Consulte a seção Comentários para obter status detalhes do valor.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Comentários

Observação

Um aplicativo que usa esse esquema deve examinar cada caractere no fluxo de dados para determinar a presença de dados modem-status ou de status de linha.

Os valores a seguir seguem o caractere de escape designado no fluxo de dados se o modo LSRMST_INSERT tiver sido ativado.

Valor Significado
SERIAL_LSRMST_ESCAPE Indica a recepção do próprio caractere de escape no fluxo de dados.
SERIAL_LSRMST_LSR_DATA Indica que ocorreu uma alteração status linha e que os dados estavam disponíveis no buffer de hardware de recebimento. Seguindo este BYTE está um valor BYTE da linha status registro é o BYTE presente no buffer de hardware de recebimento quando a linha status alteração foi processada.
SERIAL_LSRMST_LSR_NODATA Indica que ocorreu uma alteração status linha, mas nenhum dado estava disponível no buffer de hardware de recebimento.
SERIAL_LSRMST_MST Indica que ocorreu uma alteração status modem. Seguindo este BYTE está um BYTE que é o valor do modem status registrar quando o modem status alteração foi processada.

Requisitos

   
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho winioctl.h (inclua Windows.h)

Confira também