BINARY SAVE

From Atariki

Przeznaczenie: Funkcja DOS-u pozwalająca na zapis zawartości pamięci do pliku binarnego DOS-u.

Dostępność: SpartaDOS, Real.DOS (brak w SpartaDOS X i BW-DOS)

Składnia BASIC-a: XIO 41,#iocb,x1,x2,"Dn:filename.ext addr1 addr2"

Kod w asemblerze:

    ldx #iocb*16
    lda #41
    sta iccmd,x
    lda #<fname
    sta icbufa,x
    lda #>fname
    sta icbufa+1,x
    lda #x1
    sta icax1,x
    lda #x2
    sta icax2,x
    jsr jciomain

gdzie:

• iocb - numer kanału IOCB z zakresu od 1 do 7. Kanał musi być zamknięty w chwili wywołania.
• n - numer stacji dysków
• x1 - może mieć wartość $08 (utworzenie nowego pliku) lub $09 (dopisanie nowej porcji danych do istniejącego pliku)
• x2 - $00 powoduje zapis sygnatury $FFFF przed nagłówkiem, $80 powoduje wygenerowanie nagłówka bez sygnatury
• addr1 - adres pierwszego bajtu danych do zapisu, podany w postaci cyfr hex (bez poprzedzającego znaku "$")
• addr2 - adres ostatniego bajtu danych do zapisu, podany w postaci jak wyżej.
• fname - adres specyfikacji dysku. Całość ciągu znaków trzeba zakończyć znakiem EOL (ASCII $9B).

Zwracana wartość: Procedura zwraca w rejestrze Y ujemny kod błędu albo wartość $01 w przypadku powodzenia, oraz odpowiednio do tego ustawia znacznik N rejestru znaczników.