IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnsdriver.h)
IOCTL_GNSS_MODIFY_FIXSESSION 制御コードは、アクティブ・フィックス・セッションの修正セッション・パラメーターを変更するために、GNS アダプターによって使用されます。 これは、たとえば、ドライバーの SupportMultipleFixSession 機能が FALSE の場合など、同じ修正プログラムの種類の複数の修正セッションをサポートしていない場合にのみ必要です。
メジャー コード
入力バッファー
GNSS_FIXSESSION_PARAM 構造体へのポインター。
入力バッファーの長さ
sizeof(GNSS_FIXSESSION_PARAM) に設定します。
出力バッファー
NULL に設定します。
出力バッファーの長さ
0 に設定します。
状態ブロック
Irp->IoStatus.Status は、要求が成功した場合にSTATUS_SUCCESSに設定されます。 それ以外の場合は、状態 NTSTATUS コードとして適切なエラー状態に します。
備考
ドライバーは、次のいずれかの結果を示す NTSTATUS 値を設定します。
- 修正セッションが正常に変更されました。
- 修正セッションは現在停止しているか、アクティブではありません。
- 修正セッション・パラメーターを変更できませんでした。
のGNSSアダプタノート
この IOCTL を使用して、アクティブ・フィックス・セッションの修正セッション・パラメーターを変更して、LBS アプリケーションからの新しい修正要求に対応します。呼び出しが失敗した場合、新しい修正要求が既存のアクティブセッションに多重化されることはありません。 代わりに、アクティブな修正セッションが変更されていないことを期待し続けます。
呼び出しが成功した場合、以降の修正データが新しく指定されたセッション パラメーターに準拠することが、GNS アダプターによって想定されます。
GNSS ドライバー ノート
マルチセッションのサポートが存在しない場合、GNS ドライバーはこの IOCTL をサポートし、アクティブなセッションの修正セッション パラメーターをその場で変更する必要があります。修正セッション パラメーターを受け取り、検証し、それらをGNSS エンジンに送信すると、すぐに成功リターン コードを使用して I/O 要求を完了する必要があります。
正常に完了すると、新しい修正セッション パラメーターに従って、すべての修正データを返す必要があります。 ただし、既にGNSSアダプターに提供されている処理中のデータを修正することは、引き続き使用可能にする必要があり、破棄しないでください。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | gnsdriver.h |
関連項目
ドライバー での IOCTL 要求の作成の
WdfIoTargetSendInternalIoctlOthersSynchronously を する
WdfIoTargetSendInternalIoctlSynchronously
WdfIoTargetSendIoctlSynchronously を する