IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)
A solicitação IOCTL_SERIAL_GET_MODEM_CONTROL retorna o valor do registro de controle modem no controlador serial.
Para definir o registro de controle de modem, um cliente pode usar uma solicitação IOCTL_SERIAL_SET_MODEM_CONTROL .
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
O membro AssociatedIrp.SystemBuffer aponta para um buffer ULONG alocado pelo cliente que o driver do controlador serial usa para gerar o valor do registro de controle de modem.
Comprimento do buffer de saída
O membro Parameters.DeviceIoControl.OutputBufferLength é definido como o tamanho, em bytes, de um ULONG.
Bloco de status
Se a solicitação for bem-sucedida, o membro Informações será definido como o tamanho, em bytes, de um ULONG. Caso contrário, o membro Informações será definido como zero.
O membro Status é definido como um dos valores de status genéricos para solicitações de controle de dispositivo serial.
Comentários
As solicitações de IOCTL_SERIAL_GET_MODEM_CONTROL e IOCTL_SERIAL_SET_MODEM_CONTROL são usadas principalmente para teste de hardware. Nenhum layout de registro padrão é definido para as operações de controle de modem. Os drivers periféricos que usam essas IOCTLs correm o risco de se tornar dependentes dos recursos de hardware de um controlador serial específico.
Para obter um layout de exemplo de um registro de controle de modem, consulte a definição dos bits MCR (SERIAL_MCR_DTR por meio de SERIAL_MCR_LOOP) no arquivo de cabeçalho Serial.h no exemplo de driver serial no GitHub.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddser.h (inclua Ntddser.h) |