IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)

A solicitação IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS define um dispositivo serial para um modo operacional básico. O modo operacional básico da série lê e grava um byte de cada 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 painel 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 o 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 de Informações do será definido como o tamanho, em bytes, de SERIAL_BASIC_SETTINGS. Caso contrário, o membro de Informações do será definido como zero.

O membro status de é definido como um dos valores de status genérico 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

Consulte também

IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS