IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)
GNSS 配接器會使用 IOCTL_GNSS_MODIFY_FIXSESSION 控件程式代碼來修改作用中修正會話的修正會話參數。 只有在 GNSS 驅動程式不支援相同修正類型的多個修正會話時,才需要此動作,例如,當驅動程式的 SupportMultipleFixSession 功能為 FALSE 時。
主要程序代碼
輸入緩衝區
GNSS_FIXSESSION_PARAM 結構的指標。
輸入緩衝區長度
設定為sizeof (GNSS_FIXSESSION_PARAM) 。
輸出緩衝區
設定為 NULL。
輸出緩衝區長度
設定為 0。
狀態區塊
Irp->如果要求成功,IoStatus.Status 會設定為 STATUS_SUCCESS。 否則, 狀態 為適當的錯誤狀況為 NTSTATUS 程式碼。
備註
驅動程式會設定NTSTATUS值,以指出下列其中一個結果。
- 已成功修改修正會話。
- 修正會話目前已停止或未使用中。
- 無法修改修正會話參數。
GNSS 配接器附註
GNSS 配接器會使用此 IOCTL 來變更作用中修正會話的修正會話參數,以因應 LBS 應用程式的新修正要求。如果呼叫失敗,GNSS 配接器將不會將新的修正要求多倍處理到現有的使用中會話。 相反地,它會繼續預期作用中的修正會話維持不變。
如果呼叫成功,GNSS 配接器會預期後續的修正數據遵守新指定的會話參數。
GNSS 驅動程式注意事項
如果不存在多會話支援,GNSS 驅動程式必須支援此 IOCTL,並即時變更使用中會話的修正會話參數。一旦 GNSS 驅動程式接受修正工作階段參數、驗證它們,並將其傳送至 GNSS 引擎,它應該會立即完成 I/O 要求並傳回成功碼。
成功完成時,GNSS 驅動程式應該根據新的修正會話參數傳回所有修正數據。 不過,修正已在提供給 GNSS 配接器過程中的數據,仍應可供使用,且不應捨棄。
規格需求
需求 | 值 |
---|---|
標頭 | gnssdriver.h |
另請參閱
WdfIoTargetSendInternalIoctlOthersSynchronously