次の方法で共有

GNSS_EVENT_TYPE列挙 (gnsdriver.h)

  • [アーティクル]

この列挙型は、イベントの種類を示し、GNSS_EVENT 構造体によって使用されます。

GNSSドライバーは、要請された未承諾の情報をGNSRアダプタに送信するためにイベントを利用します。 イベントは、さまざまな理由で発生する可能性があります。たとえば、支援データの挿入や情報提供を目的としたドライバーの要求などです。

構文

typedef enum {
  GNSS_Event_FixAvailable,
  GNSS_Event_RequireAgnss,
  GNSS_Event_Error,
  GNSS_Event_NiRequest,
  GNSS_Event_NmeaData,
  GNSS_Event_GeofenceAlertData,
  GNSS_Event_GeofencesTrackingStatus,
  GNSS_Event_DriverRequest,
  GNSS_Event_BreadcrumbAlertEvent,
  GNSS_Event_FixAvailable_2,
  GNSS_Event_Custom
} GNSS_EVENT_TYPE;

定数

 
GNSS_Event_FixAvailable
このイベントは、アダプターからの以前の IOCTL_GNSS_GET_FIXDATA 呼び出しの結果として発生します。 アダプターが収集する修正プログラムが使用可能な場合、このイベントが発生します。 修正データは、GNSS_FIXDATA 構造の形式でイベント データに含まれます。
GNSS_Event_RequireAgnss
このイベントは、アダプターからの以前の IOCTL_GNSS_LISTEN_AGNSS 呼び出しの結果として発生します。 ドライバーは、特定の AGNSS 支援データの挿入が必要な場合は常に、このイベントを発生させます。 インジェクションの詳細は、GNSS_AGNSS_REQUEST_PARAM 構造の形式でイベント データで使用できます。
GNSS_Event_Error
このイベントは、アダプターからの以前の IOCTL_GNSS_LISTEN_ERROR 呼び出しの結果として発生します。 ドライバーは、アダプターが認識する必要がある帯域外エラーが発生したときに、このイベントを発生させます。 エラーの詳細は、GNSS_ERRORINFO 構造の形式でイベント データで使用できます。 この情報は、さまざまなデバイスによってフィールドに表示されるエラーの種類に関するテレメトリ データを取得するために Microsoft が使用できます。また、データを OEM/IHV と共有して、一般的な問題を理解し、RMS エンジンの実装の品質を向上させることができます。
GNSS_Event_NiRequest
このイベントは、ドライバがNI要求に通知する場合に発生します。 HLOS は要求を処理し (要求された場合はダイアログを表示するなど)、ドライバーに応答を挿入します。
GNSS_Event_NmeaData
このイベントは、デバイスで NMEA ログ記録が有効になっている場合、前の IOCTL_GNSS_LISTEN_NMEA 呼び出しの結果として発生します。 このイベントは、呼び出し元のクライアントが NMEA データを読み取る準備ができたときに、このイベントを発生させます。 通常、呼び出し元のクライアントはテスト ツールになります。 NMEA の文データは、GNSS_NMEA_DATA 構造の形式でイベント データに含まれます。
GNSS_Event_GeofenceAlertData
以前に作成されたジオフェンスが侵害されました。 ジオフェンスの作成時に、HLOS は、このような侵害が発生したときにアラートを特に要求していました。 たとえば、HLOS が終了アラートのみを要求している場合は、エントリのアラートを発生させるべきではありません。
GNSS_Event_GeofencesTrackingStatus
不適切な信号状態やその他の配置の問題により、1 つ以上のジオフェンスを追跡できません。 状態は、以前の障害状態から回復し、すべてのジオフェンスを追跡できるようになったときにも発生します。
GNSS_Event_DriverRequest
将来の拡張機能用に予約されています。

GNSS ドライバーは、HLOS に帯域外情報を要求しています。
GNSS_Event_BreadcrumbAlertEvent
将来の拡張機能として予約済み: 0x0012-0x7FFF。

新しいイベントの種類ごとに、アダプターによるこのイベントの開始プロセスを記述する明確に定義された IOCTL と、このイベントに関連付けられているデータ/コマンドを記述する明確に定義されたイベント データ構造があります。
GNSS_Event_FixAvailable_2
GNSS_FIXDATA_2 構造体のイベント データに含まれる修正データ。
GNSS_Event_Custom
ベンダー固有のカスタム アクション (0x8000-0xFFFF用に予約されています。

必要に応じて、このイベントが発生します。 コマンドとデータは、イベント データの一部として不透明な BLOB にパッケージ化されます。 パッケージは、GNSS ヘルパー コンポーネントにマーシャリングするためにアダプターに送信されます。

備考

イベントにはさまざまな種類を指定できます。 特定のイベントは、ドライバーによって開始された以前の要求の結果として発生します 。たとえば、修正要求を開始します。 特定のイベントは、情報提供を目的として発生します。 サポート イベントは、ドライバーが特定のアシスタンス データを挿入するアダプターを必要とする場合に発生します。

必要条件

要件 価値
サポートされる最小サーバー Windows Server 2022
ヘッダー gnsdriver.h (Gnsdriver.h を含む)