Поделиться через

структура GNSS_GEOFENCE_CREATE_PARAM (gnssdriver.h)

Структура GNSS_GEOFENCE_CREATE_PARAM определяет параметры для создания геозоны в подсистеме GNSS.

Синтаксис

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;

Члены

Size

Размер структуры.

Version

Номер версии.

AlertTypes

Это битовая маска, указывающая различные оповещения для этой геозоны, интересующей HLOS. Подсистема GNSS не должна вызывать никаких оповещений геозон, если только не запрашивается HLOS.

Если HLOS задает только GNSS_GEOFENCEALERTTYPE_ENTRY, подсистема GNSS должна отслеживать геозону все время, но вызывать оповещение только в том случае, если устройство ввело геозону. Следующее оповещение ожидается при переходе устройства из геозоны и повторного вхождения.

Если HLOS задает только GNSS_GEOFENCEALERTTYPE_EXIT, подсистема GNSS должна отслеживать геозону все время, но вызывать оповещение только в том случае, если устройство выходит из геозоны после ввода ранее. Следующее оповещение ожидается при перемещении устройства в геозону и повторном выходе.

Если HLOS задает обе битовые маски, подсистема GNSS должна отслеживать геозону все время и вызывать оповещение при перемещении и выходе устройства из геозоны.

Во всех случаях подсистема GNSS должна отдельно вызывать оповещение о состоянии глобального отслеживания, если не удается отслеживать геозоны (независимо от их параметров генерации оповещений).

InitialState

Указывает начальное состояние конкретной геозоны, как показано в HLOS. Подсистема GNSS должна использовать это состояние в качестве начального состояния геозоны, а не всегда начиная с состояния GNSS_GeofenceState_Unknown. Это позволяет подсистеме GNSS оставаться в синхронизации с HLOS с точки зрения состояний геозоны и обойти все различия в логике геозон или обнаружения выхода между подсистемой GNSS и HLOS.

Так как подсистема GNSS начинает отслеживать только что добавленную геозону, если она определяет, что геозона находится в состоянии, отличном от исходного состояния, она должна вызвать соответствующее оповещение. И наоборот, если состояния идентичны, оповещение не должно быть поднято.

Boundary

Фактическая граница геозоны.

Unused[512]

Буфер заполнения, зарезервированный для будущего использования.

Замечания

Географическая фигура используется для определения геозоны. Windows 10 в настоящее время поддерживает только циклические геозоны.

Требования

Требование Ценность
заголовка gnssdriver.h (include Gnssdriver.h)