IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)

Artigo
08/07/2023

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 a funcionalidade 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

Defina como sizeof(GNSS_FIXSESSION_PARAM).

Buffer de saída

Definido como NULL.

Comprimento do buffer de saída

Defina como 0.

Bloco de status

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

Comentários

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.
Não foi possível modificar o parâmetro de sessão de correção.

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 sigam os parâmetros de sessão recém-especificados.

Notas 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 os enviar ao 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, os dados de correção que já estão sendo fornecidos ao adaptador GNSS ainda devem ser disponibilizados e não devem ser descartados.