共用方式為


IOCTL_GNSS_MODIFY_FIXSESSION IOCTL (gnssdriver.h)

GNSS 配接器會使用 IOCTL_GNSS_MODIFY_FIXSESSION 控件程式代碼來修改作用中修正會話的修正會話參數。 只有在 GNSS 驅動程式不支援相同修正類型的多個修正會話時,才需要此動作,例如,當驅動程式的 SupportMultipleFixSession 功能為 FALSE 時。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

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

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously