IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
O código de controle IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION configura a porta serial para usar as configurações de hardware padrão para o dispositivo do controlador serial. Essas configurações são obtidas do descritor de recursos ACPI para o dispositivo do controlador serial. Para obter mais informações, consulte a especificação ACPI 5.0.
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
O membro Informações está definido como zero.
O membro Status é definido como um dos valores genéricos de status para solicitações de controle de dispositivo serial. Um status de STATUS_NOT_IMPLEMENTED indica que a porta serial não dá suporte a uma configuração padrão. Nesse caso, o cliente deve usar as outras solicitações de controle de E/S do IOCTL_SERIAL_XXX para configurar explicitamente a porta serial.
Comentários
O cliente (driver de dispositivo periférico ou aplicativo) envia esse IOCTL para definir a porta serial para usar um conjunto de configurações de conexão padrão. Essas configurações incluem parâmetros de hardware específicos da conexão, como a taxa de conexão, os valores de tempo limite e os sinalizadores de controle de fluxo.
Esse IOCTL tem suporte nas versões 1 e 2 da extensão da estrutura serial (SerCx e SerCx2). Serial.sys, que gerencia as portas seriais nomeadas (COM1, COM2 e assim por diante) em um computador, não dá suporte a essa IOCTL.
Se uma porta serial não der suporte a esse IOCTL, o cliente deverá especificar explicitamente as configurações de conexão para a porta. Ou seja, o cliente deve enviar uma solicitação de IOCTL_SERIAL_SET_BAUD_RATE para definir a taxa de baud, enviar uma solicitação IOCTL_SERIAL_SET_TIMEOUTS para definir os intervalos de tempo limite e assim por diante.
Imediatamente após um cliente abrir uma porta serial, o cliente deve assumir que a porta está configurada em um estado desconhecido e não inicializado, em vez de em algum estado conhecido e padrão.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Com suporte a partir do Windows 8. |
Cabeçalho | ntddser.h (inclua Ntddser.h) |