IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS IOCTL (ntddser.h)
A solicitação IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS restaura o modo de operação especificado de um dispositivo serial. O modo de operação especificado deve ser um modo retornado por uma solicitação de IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS . As configurações do modo de operação devem ser tratadas como opacas. Serial não verifica as configurações quando as configurações são restauradas. Observe também que uma substituição para Serial pode implementar um conjunto diferente de parâmetros.
Código principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Buffer de entrada
O membro AssociatedIrp.SystemBuffer da estrutura IRP aponta para uma estrutura de SERIAL_BASIC_SETTINGS alocada pelo cliente que é usada para inserir as configurações do modo operacional. O cliente deve usar configurações que foram retornadas por uma solicitação de IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS.
Comprimento do buffer de entrada
O membro Parameters.DeviceIoControl.InputBufferLength da estrutura IO_STACK_LOCATION é definido como o tamanho, em bytes, de uma estrutura SERIAL_BASIC_SETTINGS.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
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 estrutura. Caso contrário, o membro Informações será definido como zero.
O membro Status é 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 membro Parameters.DeviceIoControl.InputBufferLength da estrutura IO_STACK_LOCATION será menor que o tamanho, em bytes, de uma estrutura SERIAL_BASIC_SETTINGS.
Requisitos
Requisito | Valor |
---|---|
Cabeçalho | ntddser.h (inclua Ntddser.h) |