home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / lib4a86 / doc / clock.doc < prev    next >
Text File  |  1992-02-02  |  3KB  |  74 lines
  1.   ─────────────────────────────────────────────────────────────────────────────
  2.   Dokumentation zur Datei: CLOCK.INC
  3.  
  4.   ─────────────────────────────────────────────────────────────────────────────
  5.    
  6.     CLOCK.INC    - Routinen zum Lesen und Schreiben des CLOCK$-Devices
  7.                    (für den Assembler A86)
  8.    
  9.                    (c) Bernd Schemmer 1990 - 1992
  10.                    Letzter Update: 02.02.1992
  11.    
  12.    
  13.     ■ Variablen:
  14.     ------------
  15.     ClockDeviceName       - String, Name des CLOCK$-Devices, READ ONLY!
  16.    
  17.    
  18.     ■ Routinen:
  19.     -----------
  20.     ReadClockDevice       - Liest Datum und Zeit vom CLOCK$-Device
  21.     WriteClockDevice      - Schreibt Datum und Zeit ins CLOCK$-Device
  22.    
  23.    
  24.     ■ Definition des Puffers zum Lesen/Schreiben des CLOCK$-Devices
  25.    
  26.      CLOCK$_Buffer STRUC [BX]
  27.       Clock$_Tage       dw ?
  28.       Clock$_Minuten    db ? 
  29.       Clock$_Stunden    db ?
  30.       Clock$_Sek100     db ?
  31.       Clock$_Sekunden   db ?
  32.                    ENDS
  33.    
  34.     ----------------------------
  35.     ReadClockDevice
  36.    
  37.     Funktion:  Lesen des CLOCK$-Devices
  38.    
  39.     Eingabe:   DS:DX -> Puffer für die gelesen Daten (6 Byte)
  40.    
  41.     Ausgabe:   CF = 0 ->> Okay
  42.                           Puffer ist folgendermaßen gefüllt:
  43.    
  44.                           Offset | Länge | Inhalt
  45.                           -------+-------+-------
  46.                             00h  |  02h  |  Anzahl Tage seit dem 01.01.80
  47.                             02h  |  01h  |  Minuten
  48.                             03h  |  01h  |  Stunden
  49.                             04h  |  01h  |  Hundertstel Sekunden
  50.                             05h  |  01h  |  Sekunden
  51.    
  52.                CF = 1 ->> Fehler
  53.                           AX = DOS-Fehlernummer
  54.    
  55.     ----------------------------
  56.     WriteClockDevice
  57.    
  58.     Funktion:  Schreiben auf das CLOCK$-Devices
  59.    
  60.     Eingabe:   DS:DX -> Puffer mit den Daten (6 Byte)
  61.                         Aufbau wie beim Lesen, der Inhalt des Puffers wird
  62.                         nicht überprüft!
  63.    
  64.     Ausgabe:   CF = 0 ->> Okay
  65.                           Daten geschrieben
  66.                CF = 1 ->> Fehler
  67.                           AX = DOS-Fehlernummer
  68.    
  69.     Bes.:      Inkorrekte (d.h. unerlaubte) Werte im Puffer können zum
  70.                Systemabsturz führen, z.B. durch einen 'Teilerüberlauf'!!!
  71.                (Grund: Die neuen Werte werden vom CLOCK$-Device nicht
  72.                        überprüft.)
  73.    
  74.