|
Send Message Spezifikationen
|
Version 1.0.0 (24.03.2004)
Das MF (MF = Minifenster) kommuniziert mit dem Trafficdetector über die Windows-Funktion "SendMessage". Mehr über Sendmessage in der Microsoft MSDN Library
oder eine Demo für Delphi bei SwissDelphiCenter.
Jedes Programm welches Daten vom Trafficdetector bekommen möchte muss eine Anfrage stellen. Dazu muss es einfach den Text get an den Trafficdetector senden. Das hierfür benötigte Handle steht in der Registry unter HKEY_CURRENT_USER\Software\Boegesoft\TrafficdetectorV3\handle.
Darauf hin überträgt der Trafficdetector einmalig einen Datenstring der alle benötigten Daten beinhaltet.
Das Optimum für den Zeitabstand zwischen zwei anfragen beträgt 100 Millisekunden. Der TD sendet pro Anfrage den Datenstring nur einmal.
Zusätzlich können Steuerbefehle gesendet werden. Der TD merkt sich alle Handles von allen Minifenstern und sendet alle Befehle automatisch an alle MF's. Ein MF sollte somit nicht ständig sein Handle ändern.
- get(MF->TD) Bedeutet, dass der MF daten Möchte.
- close(TD->MF) Bedeutet, dass der TD beendet wird. Das MF sollte darauf hin das selbe machen. Grund hierfür können das herunterfahren von Windows sein, die manuelle Beendigung des TDs oder ein Updateversuch.
- color_??????(TD->MF) Farbänderungswunsch auf Grund eines Alarms. Für die 6 ? kommt der 6-Stellige Farbcode.
- Weitere Befehle werden in weiteren Versionen folgen.
Der Datenstring ist wie folgt aufgebaut: name=wert;(.....)
Es wird also immer ein Name und ein Wert hintereinander gesendet. Dazwischen in Gleichheitszeichen und da hinter ein Semikolon.Der Datenstring muss dann zerlegt und ausgewertet werden.Dabei ist drauf zu achten, dass das Programm Abweichungen ausgleicht. Also wenn auf Grund eines Fehlers oder eines externen Angriffes der Datenstring manipuliert wird, darf kein Fehler auftreten.
Folgend der Inhalt des Datenstrings:
- con_dau = Verbindungsdauer (in Stunden:Minuten:Sekunden)
- con_sen = Daten Gesendet in Bytes
- con_rec = Daten Empfangen in Bytes
- con_onl = Online ("true" oder "false")
- spe_sen = Geschwindigkeit Senden in KB/s
- spe_rec = Geschwindigkeit Empfangen in KB/s
- con_kos = Kosten der Verbindung (in Cent)
- mon_kos = Kosten des Monats gesamt (in Cent)
- mon_sen = Gesendet pro Monat gesamt (in bytes)
- mon_rec = Empfangen pro Monat gesamt (in bytes)
- Weitere Inhalte werden in weiteren Versionen folgen.
Ohne Gewähr.
Diese Spezifikation ist nicht bindend. Abweichungen oder Weiterentwicklung jederzeit möglich. Für Fehlerfreiheit wird keine Garantie gegeben.Wenn Sie in ihrem Programm Daten des Trafficdetectors anzeigen lassen möchten können Sie das jederzeit ohne Genehmigung von Bögesoft machen, sollten aber den "Kunden" darauf hinweisen, dass der TD für diese Funktionen benötigt wird.
|
|
