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 |
另請參閱
在驅動程式 中建立IOCTL要求
WdfIoTargetSendInternalIoctlOthersSynchronously