共用方式為


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