Deklarácia
unsigned int _stdcall ReadStoredData(StationPar *St, D2Time FromTime, D2Time ToTime, int TransId, D2Time *NextFromTime)

Parametre
St Pointer na štruktúru StationPar.
FromTime Začiatok časového intervalu, z ktorého vyžadujeme čítanie archivovaných údajov.
ToTime Koniec časového intervalu, z ktorého vyžadujeme čítanie archivovaných údajov.
TransId Identifikačné číslo transakcie, ktoré sa uvádza ako parameter call-back procedúry PointOldValue.
NextFromTime Parametrom je možné rozdeliť čítanie archivovaných hodnôt na ľubovolný počet častí.
Nenulová hodnota času znamená že čítanie bolo ukončené až po hodnoty s touto časovou značkou a staršie. Systém vygeneruje ďalšie volanie ReadStoredData kde bude hodnota FromTime rovná hodnote NextFromTime. Nulová hodnota parametera NextFromTime znamená ukončenie volania ReadStoredData. Týmto je možné rozdelenie zdĺhavých operácií čítania archívnych údajov zo zariadenia na niekoľko úsekov, medzi ktorými sú realizované prioritné čítania aktuálnych hodnôt.

Popis

Funkcia ReadStoredData (_ReadStoredData@28 v Stdcall volacej konvencii) je nepovinná a volaná za účelom získania hodnôt archivovaných v zariadení (ak to pravdaže zariadenie umožňuje). Sú požadované archivované hodnoty od času FromTime po ToTime. Pretože získavanie archivovaných hodnôt zo zariadenia môže byť zdĺhavé a blokovať prenos aktuálnych údajov (funkcie protokolovej DLL sú volané jedným taskom, to zn. sekvenčne), je možné rozdeliť získavanie archívnych hodnôt na etapy. Zápisom času nového intervalu na adresu NextFromTime sa docieli vygenerovanie ďalšieho volania funkcie ReadStoredData s daným časom FromTime. Séria volaní je ukončená zápisom 0.0 na adresu NextFromTime.

Ignorovanie funkcie sa vykoná zápisom 0.0 na adresu NextFromTime a návratovým kódom funkcie RQ_IGNORED. Hodnoty získané týmto volaním je nutné zasielať call-back volaním PointOldValue.


Návratová hodnota

Čas začiatku nasledovného intervalu čítania arch. hodnôt zapisovaný na adresu NextFromTime. Ďalej pozri návratové kódy funkcie ReadAllPoints.



Súvisiace stránky:

Napíšte komentár