Dokumentation
IPS_SetMediaCached
bool IPS_SetMediaCached (int $MedienID, bool $CacheAktiviert)
Parameterliste
| MedienID | ID des zu verändernden Medienobjekts |
| CacheAktiviert | TRUE, wenn das Medienobjekt nur im Cache verarbeitet werden soll, sonst FALSE |
Rückgabewert
Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion aktiviert bzw. deaktiviert das Cachen für ein Medienobjekt mit der ID MedienID. Ist das Cachen aktiviert, wird das Medienobjekt im Arbeitsspeicher verändert, wenn die Funktionen IPS_SetMediaContent und IPS_GetMediaContent genutzt werden. Beim Herunterfahren von IP-Symcon wird das Medienobjekt automatisch auf den physikalischen Speicher geschrieben und somit persistent. Wird das Cachen deaktiviert, wird der Inhalt aus dem Arbeitsspeicher zuvor in die Datei des Medienobjekts geschrieben, sodass keine Änderungen verloren gehen.
Diese Funktion dient zur Schonung von SSDs und Flashspeichern.
Beispiel
$MediaID = IPS_CreateMedia(MEDIATYPE_IMAGE); // Image im MedienPool anlegen
IPS_SetMediaCached($MediaID, true);
// Das Cachen für das Mediaobjekt wird aktiviert.
// Beim ersten Zugriff wird dieses von der Festplatte ausgelesen
// und zukünftig nur noch im Arbeitsspeicher verarbeitet.