Compartilhar via


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

IRP_MJ_DEVICE_CONTROL

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)

Confira também

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS