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 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 AssociatedIrp.SystemBuffer membro 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 as configurações retornadas por uma solicitação de IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS.
Comprimento do buffer de entrada
O Parameters.DeviceIoControl.InputBufferLength membro 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 de Informações do será definido como o tamanho, em bytes, de SERIAL_BASIC_SETTINGS estrutura. 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 o Status estiver definido como STATUS_BUFFER_TOO_SMALL, o Parameters.DeviceIoControl.InputBufferLength membro 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) |