estrutura GNSS_GEOFENCE_CREATE_PARAM (gnssdriver.h)

A estrutura GNSS_GEOFENCE_CREATE_PARAM define os parâmetros para criar uma cerca geográfica no mecanismo GNSS.

Sintaxe

typedef struct {
  ULONG               Size;
  ULONG               Version;
  ULONG               AlertTypes;
  GNSS_GEOFENCE_STATE InitialState;
  GNSS_GEOREGION      Boundary;
  BYTE                Unused[512];
} GNSS_GEOFENCE_CREATE_PARAM, *PGNSS_GEOFENCE_CREATE_PARAM;

Membros

Size

Tamanho da estrutura.

Version

Número da versão.

AlertTypes

Essa é uma máscara de bits que indica os vários alertas para essa cerca geográfica em que o HLOS está interessado. O mecanismo GNSS não deve gerar alertas de cerca geográfica, a menos que seja solicitado especificamente pelo HLOS.

Se o HLOS definir apenas GNSS_GEOFENCEALERTTYPE_ENTRY, o mecanismo GNSS deverá acompanhar a cerca geográfica o tempo todo, mas gerar alerta somente quando o dispositivo tiver inserido a cerca geográfica. O próximo alerta é esperado quando o dispositivo sai da cerca geográfica e retorna.

Se o HLOS definir apenas GNSS_GEOFENCEALERTTYPE_EXIT, o mecanismo GNSS deverá acompanhar a cerca geográfica o tempo todo, mas gerar alerta somente quando o dispositivo tiver saído da cerca geográfica depois de inseri-la anteriormente. O próximo alerta é esperado quando o dispositivo se move dentro da cerca geográfica e sai novamente.

Se o HLOS definir as duas máscaras de bits, o mecanismo GNSS deverá acompanhar a cerca geográfica o tempo todo e gerar alerta à medida que o dispositivo entra e sai da cerca geográfica.

Em todos os casos, o mecanismo GNSS deve gerar separadamente o alerta de status de rastreamento global se não for possível rastrear as cercas geográficas (independentemente de suas configurações de alerta).

InitialState

Indica o estado inicial da cerca geográfica específica, conforme visto pelo HLOS. O mecanismo GNSS deve usar esse estado como o estado inicial da cerca geográfica, em vez de sempre começar do estado GNSS_GeofenceState_Unknown. Isso permite que o mecanismo GNSS permaneça em sincronia com o HLOS em termos dos estados de cerca geográfica e contornar quaisquer diferenças na entrada de cerca geográfica ou na lógica de detecção de saída entre o mecanismo GNSS e o HLOS.

À medida que o mecanismo GNSS começa a rastrear a cerca geográfica recém-adicionada, se determinar que a cerca geográfica está em um estado diferente desse estado inicial, ele deve gerar o alerta apropriado. Por outro lado, se os estados forem idênticos, nenhum alerta deverá ser gerado.

Boundary

O limite real da cerca geográfica.

Unused[512]

Buffer de preenchimento reservado para uso futuro.

Comentários

Uma forma geográfica é usada para definir uma cerca geográfica. Windows 10 atualmente dá suporte apenas a cercas geográficas circulares.

Requisitos

Requisito	Valor
Cabeçalho	gnssdriver.h (inclua Gnssdriver.h)