ReadStoredData

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.

Súvisiace stránky:

D2000 KomAPI - funkcie

Strom stránky

Page Not Available