CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Zusatzfunktionen /

QueryMediaType - Typ des Speichermediums

CxiLong CxiTree :: QueryMediaType ()
CxiLong cxiQueryMediaType (CxiHandle self)

Liefert die Art des Speichermediums, das der Baum benutzt

return:
Typ des Speichermediums (siehe Text)

Diese Funktion liefert einen Wert zurück, der angibt, wo der Baum seine Daten ablegt (Heap, Datei, Cache, ...) und ob er ein Objekt vom Typ CxiTreeSubst ist.

Die unteren 4 Bit des Rückgabewerts zeigen an, welches Medium zur Ablage der nicht im Sichtfenster befindlichen Daten benutzt wird, dieser Wert kann durch eine UND-Verknüpfung der Rückgabe mit cxiMediaTypeMask (0x0F) errechnet werden:

cxiMediaTypeNone (0)
Es ist ein Fehler aufgetreten, oder das Objekt ist kein Baum (CxiTree), sondern nur ein einzelner Knoten (CxiNode).

cxiMediaTypeMem (1)
Die Daten werden auf dem Heap des Programms abgelegt (CxiTreeMem).

cxiMediaTypeFile (2)
Die Daten werden in einer Datei abgelegt (CxiTreeFile).

cxiMediaTypeFileShadow (3)
Die Daten entstammen einer Datei, sind aber vollständig in den Speicher geladen worden (CxiTreeFile mit Option "b"). Die Datei wird nicht mehr benötigt.

cxiMediaTypeDummy (4)
Dieser Typ wird intern vom Meldungssystem genutzt.

cxiMediaTypeFlat (5)
Die Daten sind in einem zusammenhängenden Speicherblock abgelegt (CxiTreeFlat). Dieser Typ wird momentan nur intern vom Meldungssystem genutzt, er wird demnächst allgemein zur Verfügung gestellt.

Ist das Objekt vom Typ CxiTreeSubst, so wird das Bit cxiMediaTypeSubst (0x10) gesetzt, und die übrigen Bits liefern den Typ des Basisobjekts.

Portabilität:
Diese Funktion ist ab Version 2.05 definiert und in allen unterstützten Systemen verfügbar.