本文簡(jiǎn)單介紹OPC HDA規(guī)范的IOPCHDA_Playback（可選）接口方法，更多通信資源請(qǐng)登錄網(wǎng)信智匯(wangxinzhihui.com)。

此接口支持歷史服務(wù)器的播放功能。這提供了從歷史服務(wù)器獲得初始數(shù)據(jù)集的能力，然后獲得歷史數(shù)據(jù)的持續(xù)更新。這與異步建議方法的不同之處在于，這些方法以當(dāng)前時(shí)間為中心?；胤沤涌谥С謴倪^(guò)去檢索數(shù)據(jù)，然后從存儲(chǔ)的數(shù)據(jù)中提供更新的方法。通常，更新以比數(shù)據(jù)存儲(chǔ)時(shí)更頻繁的速率發(fā)送。例如，請(qǐng)求可以是每分鐘發(fā)送10分鐘的數(shù)據(jù)。

?

1）HRESULT ?ReadRawWithUpdate(dwTransactionID, htStartTime, htEndTime, dwNumValues, ftUpdateDuration, ftUpdateInterval, dwNumItems, phServer, pdwCancelID, ppErrors)

此操作最初將檢索從開(kāi)始時(shí)間到結(jié)束時(shí)間的數(shù)據(jù)。在初始響應(yīng)之后，它將定期（以ftUpdateInterval）響應(yīng)由ftUpdateDuration標(biāo)識(shí)的數(shù)據(jù)量。初始響應(yīng)的結(jié)束時(shí)間用作第一次更新的開(kāi)始時(shí)間。之后，上次更新的結(jié)束時(shí)間被用作下一次更新的開(kāi)始時(shí)間。

此功能用于播放原始?xì)v史數(shù)據(jù)。通過(guò)控制更新間隔，數(shù)據(jù)可以實(shí)時(shí)、慢速或比實(shí)時(shí)更快地顯示在趨勢(shì)上。

結(jié)果通過(guò)客戶端的IOPCHDA_DataCallback:：OnPlayback方法返回。

僅支持向前播放。初始請(qǐng)求的域由htStartTime、htEndTime和dwNumValues定義。必須定義htStartTime的值。如果未指定htEndTime，則該請(qǐng)求應(yīng)針對(duì)htStartTime中所請(qǐng)求值數(shù)的所有數(shù)據(jù)。然后，應(yīng)根據(jù)上次返回值時(shí)的ftUpdateDuration和ftUpdateInterval發(fā)送進(jìn)一步的數(shù)據(jù)。

如果htStartTime或htEndTime是以字符串（相對(duì)）格式給定的，則OPCHDA_time結(jié)構(gòu)（ftTime）的絕對(duì)時(shí)間將設(shè)置為服務(wù)器將相對(duì)時(shí)間轉(zhuǎn)換為的FILETIME。

該請(qǐng)求繼續(xù)以dwNumvals的塊發(fā)送數(shù)據(jù)，直到所有請(qǐng)求的數(shù)據(jù)都已發(fā)送，返回可用于取消請(qǐng)求的事務(wù)ID，并使用組上的更新率來(lái)限制塊返回率。

dwNumValues定義了將在單個(gè)回調(diào)中返回的任何項(xiàng)的最大值數(shù)。這可能是針對(duì)初始數(shù)據(jù)集或任何后續(xù)更新（因此請(qǐng)注意，更新可能需要多個(gè)回調(diào)）。

操作的實(shí)現(xiàn)取決于服務(wù)器。

?

2）HRESULT ?ReadProcessedWithUpdate(dwTransactionID, htStartTime, htEndTime, ftResampleInterval, dwNumIntervals, ftUpdateInterval, dwNumItems, phServer, haAggregate, pdwCancelID, ppErrors)

該方法在標(biāo)準(zhǔn)的v1.0和v1.1之間進(jìn)行了更改，以將haAggregate作為DWORD而非ENUM傳遞，從而允許供應(yīng)商指定自己的聚合。使用該標(biāo)準(zhǔn)v1.0構(gòu)建的服務(wù)器和客戶端將與使用v1.1構(gòu)建的服務(wù)器或客戶端協(xié)同工作，但v1.0客戶端可能與返回供應(yīng)商指定聚合的v1.1服務(wù)器不兼容。

此操作最初將檢索從開(kāi)始時(shí)間到結(jié)束時(shí)間的數(shù)據(jù)。在初始響應(yīng)之后，它將周期性地（以ftUpdateInterval）響應(yīng)dwNumIntervals數(shù)量的數(shù)據(jù)，這些數(shù)據(jù)被劃分為ftResampleInterval大小的倉(cāng)。初始響應(yīng)的結(jié)束時(shí)間用作第一次更新的開(kāi)始時(shí)間。之后，上次更新的結(jié)束時(shí)間被用作下一次更新的開(kāi)始時(shí)間。這是接口上的一個(gè)可選方法。

此功能用于播放處理過(guò)的歷史數(shù)據(jù)。通過(guò)控制更新間隔，數(shù)據(jù)可以實(shí)時(shí)、慢速或比實(shí)時(shí)更快地顯示在趨勢(shì)上。

結(jié)果通過(guò)客戶端的IOPCHDA_DataCallback:：OnPlayback方法返回。

初始請(qǐng)求的域由htStartTime、htEndTime和ftResampleInterval定義。如果htStartTime或htEndTime是以字符串（相對(duì)）格式給定的，則返回的值將是服務(wù)器將該值轉(zhuǎn)換為的FILETIME。必須指定這三個(gè)。htEndTime必須大于htStartTime。

ftResampleInterval確定將整個(gè)間隔劃分為多少個(gè)子間隔。指定的函數(shù)在以htStartTime開(kāi)始的每個(gè)子區(qū)間計(jì)算，并選擇下一個(gè)ftResampleInterval內(nèi)的數(shù)據(jù)，將根據(jù)每個(gè)子區(qū)間的haAggregate計(jì)算一個(gè)值。

對(duì)于與聚合值一起使用的MinimumActualTime和MaximumActualTime，如果在一個(gè)時(shí)間范圍內(nèi)存在該值的多個(gè)實(shí)例，則返回該值的哪個(gè)實(shí)例（時(shí)間戳）取決于服務(wù)器。在任何情況下，服務(wù)器可以設(shè)置OPCHDA_EXTRADATA質(zhì)量標(biāo)志，以使呼叫者知道存在具有該值的其他時(shí)間戳。

更新的域由上次返回值的時(shí)間ftResampleInterval和dwNumIntervals定義。

ftResampleInterval為0是非法的，導(dǎo)致返回狀態(tài)為E_INVALIDARG。如果只需要初始數(shù)據(jù)集，則dwNumIntervals應(yīng)設(shè)置為0。請(qǐng)求仍必須取消。

FTUpdateInterval不能小于FTResampleInterval。

返回的數(shù)據(jù)的順序?qū)⑴c請(qǐng)求中ItemID的順序相匹配。

?

3）HRESULT ?Cancel(dwCancelID)

此功能取消未完成的操作。實(shí)際實(shí)現(xiàn)是特定于服務(wù)器的，但服務(wù)器將通過(guò)OPCHDA_CancelComplete回調(diào)進(jìn)行響應(yīng)，除非調(diào)用返回FAILED錯(cuò)誤代碼。

?

未完待續(xù)。更多通信資源請(qǐng)登錄網(wǎng)信智匯(wangxinzhihui.com)。