API の使用

DR-DOS システムコールパラメータ

システムコールのエラー戻り値

FCB 指向のファイル管理

システムコール一覧

このセクションでは、アプリケーションプログラムから Caldera DR-DOS のファンクションコールと割り込みを使うために必要な情報を示します。

2.1 DR-DOS システムコールパラメータ

DR-DOS では、AH レジスタにファンクション番号を代入し、必要に応じて追加情報をその他のレジスタに入れ、しかる後 INT 21h を発行することによって、プロセスがファンクションを呼び出します。 DR-DOS が制御を得ると、スタックが DR-DOS 内部スタックに切りかわります。 個別の要求に応じて情報が返されない限り、AX 以外のレジスタは保持されます。 システムの割り込みを考慮し、ユーザのスタックサイズをユーザプログラム内部の必要量より 128 バイト以上多くしておくべきでしょう。

2.1.1 ASCIZ 入力文字列

Table 2-1 のシステムコールは、入力パラメータとして、DS:DX レジスタに ASCIZ 文字列のアドレスが必要です。 ASCIZ 文字列は、任意のドライブ文字とディレクトリパスを含めた ASCII 文字の並びです。 場合によっては、文字列にファイル名も含まれます。 ASCIZ 文字列はゼロ、もしくはヌルバイト (0h) で区切られています。 パス名はバックスラッシュ、もしくは円記号 (\) で区切られています。

2.1.2 ファイルとデバイスハンドル

ファイル作成 (3Ch)、ファイルオープン (3Dh)、ファイルハンドル複製 (45h)、ファイル新規作成 (45h) といったファンクションでは、AX レジスタに 16 ビットの識別値を返します。 これを「ハンドル」と呼びます。 ハンドルはそれ以降、そのハンドルを返したシステムコールよって作成されるか開かれるかしたファイル、もしくはデバイスの識別に使われます。 Table 2-2 は標準デバイスに対応してあらかじめ定義されているハンドルの一覧です。 これらのハンドルは事前にデバイスを開いて割り付けることなく、プログラムで使用できます。

2.2 システムコールのエラー戻り値

DR-DOS の呼び出しが成功した場合、ほとんどの呼び出しでキャリーフラグをクリアします。 エラーがある場合、キャリーフラグがセットされ、AX レジスタにエラーコードが返されます。 Chapter 5 に、AX レジスタに返されるエラーコードの一覧があります。

2.3 FCB 指向のファイル管理

2.3.1 標準 DR-DOS ファイルコントロールブロック (FCB)

Fugure 2-1 は標準ファイルコントロールブロック (FCB) を図示しています。 Table 2-3 は標準 FCB フィールドを定義しています。 オフセット 10h から 1Fh までのフィールド (FILESIZE, DATA そして RESERVED) は DR-DOS によって設定され、ユーザプログラムによる変更をしてはなりません。 標準 FCB の残りのフィールドはすべてユーザプログラムが設定しなければなりません。

WORD 形式のフィールドはすべて、最下位バイトを先頭にして格納されています（DWORD も）。

2.3.2 拡張 FCB

拡張 FCB を使い、特別な属性を持つファイルの作成、もしくは検索をすることができます。

拡張 FCB は通常の FCB の前方に 7 バイトの前置（プレフィクス）が付加されます。 Figure 2-2 では FCB プレフィクスのフォーマットを示していますが、その位置は通常の FCB の先頭からのオフセット値になっています。

2.3.3 ファイルアトリビュートバイト

ファイル作成時に、ファイルに対してひとつ以上のアトリビュート（属性）を設定することができます。 ディレクトリエントリや拡張 FCB プレフィクス内に現れるアトリビュートバイトは、Table 2-5 の一覧にある値をとります。

ファイルモード変更 (43h) コールを用いて、リードオンリー、ヒドン、システム、アーカイブのアトリビュートを変更することができます。 ファイルはこれら４つのいくつか、もしくはすべてを組み合わせたアトリビュートを持つことができます。 ファイルモード変更コールでボリュームラベルとサブディレクトリのアトリビュートを変更することはできません。

ファイル検索でのアトリビュートバイトの用法説明は、Chapter 4 にある最初のエントリ検索 (11h) の記述中に含まれています。

2.3.4 ディスク転送エリア (DTA)

DR-DOS では、すべての FCB でのファイルリードおよびライトでデータ格納のために、そしてその他の FCB 指向でないファンクションコールのいくつかのために、ディスク転送エリア (DTA) を使用しています。 DTA を使用するファンクションには、以下のものが含まれます。

最初のエントリ検索 (11h) Search First Entry

次のエントリ検索 (12h) Search Next Entry

FCB シーケンシャルリード (14h) Sequentical Read

FCB シーケンシャルライト (15h) Sequentical Write

FCB ランダムリード (21h) Random Read

FCB ランダムライト (22h) Random Write

FCB ランダムブロックリード (27h) Random Block Read

FCB ランダムブロックライト (28h) Random Block Write

DOS プログラムに制御を与えたとき、DR-DOS は、デフォルトの DTA をプログラム中の PSP のオフセット 80h に設置します。 プログラムのロードと実行 (4Bh) コール中にある PSP の記述を参照のこと。

DTA の大きさはデフォルトで 128 バイトです。 デフォルト DTA を変更、もしくは新しい DTA を設置するには、ディスク転送アドレスのセット (1Ah) コールを使用します。 DR-DOS はメモリ中のどの位置にでも DTA の配置を認めていますが、64 キロバイトの（セグメントの）境界をまたぐことはできません。

いちど DTA が設置されると、その後で DTA のセットが起こるまで、DR-DOS はすべてのディスク操作でそのエリアを使い続けます。 ディスク転送アドレスの取得 (2Fh) コールで現在の DTA アドレスを取得することができます。

システムコール一覧

Table 2-6 は DR-DOS によってサポートされるシステムファンクションの一覧です。 システムコールは以下のカテゴリに分類されています。

• キャラクタデバイス入出力 Character Device I/O
• ファイル管理 File Management
• 拡張ファイル管理 Extended File Management
• ディレクトリ管理 Directory Management
• もろもろ Miscellaneous
• プログラム制御 Program Control
• メモリ管理 Memory Management
• 時刻 Time
• 国別情報 Country Information
• ネットワーク Networking