IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)

Artigo
02/07/2025

O código de controle IOCTL_GNSS_MODIFY_FIXSESSION é usado pelo adaptador GNSS para modificar os parâmetros de sessão de correção de uma sessão de correção ativa. Isso só é necessário quando o driver GNSS não dá suporte a várias sessões de correção do mesmo tipo de correção, por exemplo, quando o recurso SupportMultipleFixSession do driver é FALSE.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um ponteiro para uma estrutura GNSS_FIXSESSION_PARAM.

Comprimento do buffer de entrada

Definido como sizeof(GNSS_FIXSESSION_PARAM).

Buffer de saída

Definido como NULL.

Comprimento do buffer de saída

Definido como 0.

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, status à condição de erro apropriada como um código de NTSTATUS.

Observações

O driver define um valor NTSTATUS para indicar um dos resultados a seguir.

A sessão de correção foi modificada com êxito.
A sessão de correção está parada ou não está ativa no momento.
O parâmetro de sessão de correção não pôde ser modificado.

notas do adaptador GNSS

O adaptador GNSS usa esse IOCTL para alterar os parâmetros de sessão de correção de uma sessão de correção ativa para acomodar novas solicitações de correção dos aplicativos LBS.

Se a chamada falhar, o adaptador GNSS não multiplexará a nova solicitação de correção para a sessão ativa existente. Em vez disso, ele continuará esperando que a sessão de correção ativa permaneça inalterada.

Se a chamada for bem-sucedida, o adaptador GNSS esperará que os dados de correção subsequentes aderem aos parâmetros de sessão recém-especificados.

anotações do driver GNSS

Se o suporte a várias sessões não estiver presente, o driver GNSS deverá dar suporte a esse IOCTL e alterar os parâmetros de sessão de correção em tempo real para a sessão ativa.

Depois que o driver GNSS aceitar os parâmetros de sessão de correção, validá-los e enviar para o mecanismo GNSS, ele deverá concluir imediatamente a solicitação de E/S com um código de retorno de êxito.

Após a conclusão bem-sucedida, o driver GNSS deve retornar todos os dados de correção de acordo com os novos parâmetros de sessão de correção. No entanto, a correção de dados que já estão em processo de ser fornecidas ao adaptador GNSS ainda deve ser disponibilizada e não devem ser descartadas.