次の方法で共有

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は現在、円形ジオフェンスのみをサポートしています。

要件

要件 値
Header gnssdriver.h (Gnssdriver.h を含む)