IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
A solicitação IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS define um dispositivo serial como um modo operacional básico. O modo operacional básico da série lê e grava um byte por vez e não usa controle de fluxo de handshake ou tempos limite. O modo de operação básico é adequado para uso por um driver que usa um subconjunto da interface UART 16550. Exemplos desses drivers incluem um driver de mouse ou um driver de teclado gráfico para hardware mais antigo que usa um UART 16450.
A solicitação IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS retorna as configurações de modo operacional que estão em uso pouco antes de Serial definir o modo de operação básico. Um cliente usa uma solicitação IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS para restaurar um modo operacional anterior. Um cliente deve tratar as configurações do modo operacional como opacas. Serial não verifica as configurações quando as configurações são restauradas. Observe também que um driver de substituição para Serial pode implementar um conjunto diferente de configurações básicas.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
O AssociatedIrp.SystemBuffer aponta para uma estrutura de SERIAL_BASIC_SETTINGS alocada pelo cliente que Serial usa para gerar a configuração atual.
Comprimento do buffer de saída
O Parameters.DeviceIoControl.OutputBufferLength é definido como o tamanho, em bytes, de uma estrutura SERIAL_BASIC_SETTINGS.
Bloco de status
Se a solicitação for bem-sucedida, o membro Informações será definido como o tamanho, em bytes, de SERIAL_BASIC_SETTINGS. 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. Se Status for definido como STATUS_BUFFER_TOO_SMALL, o valor de Parameters.DeviceIoControl.OutputLength será menor que o tamanho, em bytes, de uma estrutura SERIAL_BASIC_SETTINGS.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddser.h (inclua Ntddser.h) |