IApi.FoeReadFileToBuffer 方法

從伺服驅動器讀取檔案並將其儲存於使用者應用程式的記憶體空間中。

命名空間：IntervalZero.KINGSTAR.Base.Api

組合： IntervalZero.KINGSTAR.Base.Api (於 IntervalZero.KINGSTAR.Base.dll) 版本：4.4.0.0

語法

C#VB

KsCommandStatus FoeReadFileToBuffer(
       int SlaveId,
       bool BootState,
       string Name,
       uint Password
)

Function FoeReadFileToBuffer(
       SlaveId As Integer,
       BootState As Boolean,
       Name As String,
       Password As UInteger
) As KsCommandStatus

參數

SlaveId

型別：int

從站陣列的索引。當 EtherCAT 從站裝置啟動時，此索引具有與 SlaveId 相同的值，該值對應於從站裝置在網路中的位置。請注意，在 EtherCAT 進入運行 (Op) 狀態後，加入或移除網路上的任何從站裝置將改變各裝置在網路中的位置 (SlaveId)。儘管如此，從站的索引將保持不變。新增的裝置將排列在陣列的末端。對於更改後的所有從站，索引和 SlaveId 將不再匹配。上述行為模式僅適用於實體裝置；不適用於模擬裝置。詳細資訊請參閱 EnableHotConnect 中的使用案例。

BootState

型別：bool

判定從站是否處於 Bootstrap (Boot) 狀態以使用 FoE。Boot 狀態可用於更新韌體或配置從站的設定。

true：Boot 狀態。

false：正常狀態。

Name

型別：string

從裝置讀取檔案名稱。

Password

型別：uint

若裝置需要密碼以存取檔案，則需在此設定密碼，0 表示無密碼。

回傳值

型別：KsCommandStatus

回傳 KsCommandStatus 類別。

備註

當 EtherCAT 連結正常開啟，從站狀態將為 Init -> PreOp -> SafeOp -> Op，若在從站狀態為 Op 時使用此方法，並設定 BootState 為 true，則從站狀態的變更將為 Op -> Init -> Boot，當任務完成，其狀態將再次變更為 Init -> PreOp -> SafeOp -> Op。
此方法只能在 RTX64 中作為指標使用，無法在 RTX64 和 Windows 之間共享。

可用的 EtherCAT 狀態

ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

範例

N/A

參見

IApi 介面

IntervalZero.KINGSTAR.Base.Api 命名空間