DR-DOS のシステムコール

本セクションは DR-DOS システムファンクションの詳解を与えます。 本セクションでは利用の便をはかり、ファンクション仕様は番号順に整理されています。 システムファンクションのカテゴリ別の紹介は 2.4 のシステムコール一覧に示されています。

いくつかのシステムコールはエラー情報を返し、システムコール記述中でそれについて言及があるかもしれません。 システムコールで返されるエラー情報の種別について、より広範な情報が Chapter 5 で提供されており、それを読んでエラーコードの全容を把握することをおすすめします。

（訳注 : このドキュメントでは残念ながら、DR-DOS が実装しているファンクションコールのすべてを説明しているわけではありません。 つまり文字どおりの意味で "Undocumented" なファンクションが存在します。 もっともカーネルソースは公開されているので、それを読めばわかるのですが、しかし… ）

PSP に保存されたプログラム終了アドレス、Ctrl-Break アドレス、致命的エラーアドレスを元に戻します。 これらの値はエントリー時、プログラム終了のために保存されています。

プログラムのロードと実行 (4Bh) コールの PSP 制御ブロック説明図 (Figure 4-6) を参照してください。

すべてのバッファをフラッシュし、終了アドレスに制御を移します。 ファイル長を変更し、クローズしていないファイルのディレクトリ情報を、DR-DOS が正しく記録しないことに注意してください。 本ファンクション呼び出しの前に、CS レジスタには、呼び出し元プログラムの PSP セグメントのアドレスを入れておかねばなりません。

本ファンクションコールは新しい（訳注 : 要するに DOS 2.0 以降）プログラムで使うべきではありません。 既存の（訳注 : 要するに DOS 1.x）プログラムのためのみにサポートされています。 プロセス終了 (4Ch) が、この機能のためのより妥当なファンクションコールです。

呼び出し元の標準入力デバイスから一文字読み取り、その文字を標準入力に書き込み（エコー）、それから AL レジスタに返します。 文字が読み取り状態でない場合は、呼び出し元プロセスに戻る前にキーボード入力を待ちます。

キーボード入力が Ctrl-Break を読み取ったときは、INT 23h を実行します。 呼び出し元プロセスが拡張 ASCII コード文字を読み出したいときは、キーボード入力ファンクションを２回呼び出さねばなりません。 キーボード入力が AL レジスタに 00h を返した場合は、それに続くファンクションコールが拡張アスキーコード文字を返すことを示しています。

（訳注 : 拡張アスキーコード云々は PC/AT 互換機系の独自情報だと思う。というか AT の INT 16h キーボード BIOS がそういう仕様になっている。もっとも日本語とかの２バイト文字を読み取る場合は、やっぱり文字コードを判別して２度呼びしないといけないのですが…）

呼び出し元プロセスの標準出力デバイスに文字を出力します。 DL がバックスペース文字 (08h) の場合、コンソール出力ファンクションはカーソルを左にひとつ分移動させます。 （訳注 : コンソールドライバ側の仕様に依存します。たとえば標準出力がファイルにリダイレクトされている場合、ファイルにはバックスペースの文字コードがそのまま出力されるだけです）

Ctrl-Break を検出すると、文字出力完了後に INT 23h を実行します。

標準補助デバイスから次のバイトを読み取り、AL レジスタに返します。

DL レジスタの内容を標準補助デバイスに書き込みます。

DL レジスタの内容を標準プリンタデバイスに書き込みます。

DL レジスタの内容が FFh のとき、本ファンクションは標準入力から文字を読み取り、ゼロフラグをクリア、そして AL レジスタに文字を返します。 入力デバイスに文字がない場合にはゼロフラグをセットし、AL レジスタに 00h を返します。

DL レジスタに FFh 以外の値が入っている場合、DL の内容は標準出力に書き込まれる文字とみなされます。 直接コンソール入出力ファンクションは、コンソールからの Ctrl-Break や Ctrl-PrtSc をチェックしません。

呼び出し元プロセスが拡張 ASCII コード文字を読み出したいときは、直接コンソール入出力ファンクションを２回呼び出さねばなりません。 直接コンソール入出力が AL レジスタに 00h を返した場合は、それに続くファンクションコールが拡張アスキーコード文字を返すことを示しています。 （訳注 : キーボード入力 (01h) 参照）

呼び出し元プロセスの標準入力デバイスから 1 文字読み取り、AL レジスタに返します。 入力デバイスに文字がない場合、呼び出しプロセスに戻る前に文字入力を待ちます。

呼び出し元プロセスが拡張 ASCII コード文字を読み出したいときは、本ファンクションを２回呼び出さねばなりません。 AL レジスタに 00h を返した場合は、それに続くファンクションコールが拡張アスキーコード文字を返すことを示しています。 （訳注 : キーボード入力 (01h) 参照）

エコーなし直接コンソール入力ファンクションは、コンソールからの Ctrl-Break や Ctrl-PrtSc をチェックしません。

呼び出し元プロセスの標準入力から 1 文字読み取り、AL レジスタに返します。 文字が読みだし状態にない場合は、元プロセスに戻る前に文字を待ちます。

Ctrl-Break を検出した場合、INT 23h を実行します。 呼び出し元プロセスが拡張 ASCII コード文字を読み出したいときは、本ファンクションを２回呼び出さねばなりません。 AL レジスタに 00h を返した場合は、それに続くファンクションコールが拡張アスキーコード文字を返すことを示しています。 （訳注 : キーボード入力 (01h) 参照）

DS:DX で始まり、$ 文字 (24h) で終わる ASCII 文字列を標準出力デバイスに送ります。 文字列がバックスペース文字 (08h) を含む場合、カーソルを左にひとつ分移動させます。 （訳注 : コンソールドライバ側の仕様に依存します。コンソール出力 (02h) 参照）

ユーザが Ctrl-Break を入力した場合、文字列をコンソールに出力後に INT 23h を実行します。

（訳注 : $ 文字そのものは出力できません。もし $ 文字を表示したい場合には、別のファンクションを使う必要があります）

呼び出し元プロセスの標準入力デバイスから文字を読み取り、DS:DX レジスタで始まるアドレスの入力バッファに書き込みます。 Figure 4-1 に入力バッファのフォーマットを示します

先頭バイト (MAX) は、バッファが保持できる最大文字数を指定します。 DR-DOS は受け取った文字数を 2 番目のバイト (NCHARS) にセットします。 NCHARS にはキャリッジリターン終端文字 (0Dh) は含まれていません。 入力デバイスから読み取られた文字は 3 番目のバイト（オフセット 02h）以降に書き込まれます。 キャリッジリターン (0Dh) を読み込んだとき、ファンクションはバッファへの書き込みを中止します。

入力バッファが MAX - 1 の文字で詰まったとき、キャリッジリターンが読み込まれるまで追加入力は無視され、ベル音を鳴らします。

Note: 文字入力時には DR-DOS の編集キーとコマンドラインヒストリが使えます。

標準入力デバイスに文字が用意されているときは、AL レジスタに FFh を返します。 00h を返す場合は、文字が用意されていません。 Ctrl-Break を検出したときは INT 23h を実行します。

標準入力デバイスの先行入力を破棄し、AL レジスタに書かれた番号のファンクションコールを呼び出します。 以下の番号のシステムコールに処理を渡すことができます。

01H - キーボード入力

06H - 直接コンソール入出力

07H - エコーなし直接コンソール入力

08H - エコーなしコンソール入力

0AH - バッファコンソール入力

変更があったバッファの内容をすべてディスクに書き込んで、全ファイルバッファをフラッシュします。 オープンしたままで、なおかつ長さが変更されているファイルのディレクトリ情報は更新しません。 （更新するにはファイルクローズ、もしくはファイルのコミット (68h) を使わねばなりません）

定義されたエラーコードは Chapter 5 を参照してください。

本ファンクションは、DL で指定されたドライブが有効かまず判別し、それからデフォルトドライブとして選択します。 ドライブ番号はゼロから始まり、0 が A、1 が B、以下同様です。

AL はシステムの最終ドライブ番号を返します。 たとえば、AL = 5 の場合、最終ドライブは E: です。 COFIG.SYS ファイル中に LASTDRIVE= ステートメントが含まれ、そこで最終物理ドライブより大きい値が指定されていない場合、AL の値は、初期化の際に発見された最後の物理ドライブ番号です。 （訳注 : たとえば CONFIG.SYS 中に LASTDRIVE=Z の指定がある場合、AL には 1Ah (26) が返されます。しかし A: から Z: までの全ドライブが有効であるとは必ずしもいえないわけです）

（未訳）

（未訳）

DS:DX で指定される未オープン FCB にマッチする最初のファイル名を、カレントディレクトリで検索します。 ファイル名には疑問符 ('?') を含めることができ、疑問符はその位置にあるすべての文字とマッチします。 呼び出し元プログラムが拡張 FCB を指定している場合、FCB プレフィクス中にあるアトリビュートバイトの内容を元にして検索を行います。 （拡張 FCB については、2.3.2 拡張 FCB を参照してください） Table 4-1 はアトリビュートバイト値の一覧です。 （訳注 : 2.3.2 ファイルアトリビュートバイトも参照のこと）

マッチするファイルを発見しなかった場合、AL には FFh が返されます。 実際のエラー状況を判別するには、拡張エラーコード取得 (59h) ファンクションを使用してください。

マッチするファイルを発見した場合、AL には 00h が返され、呼び出し元プログラムのディスク転送アドレス (DTA) に情報が置かれます。 この情報は、普通の FCB と 拡張 FCB のどちらが指定されているかによって異なります。

検索 FCB が普通の FCB である場合、呼び出し元 DTA の先頭バイトにマッチする FCB のドライブ番号をセットし、ドライブ番号は A が 1、B が 2、以下同様です。 DR-DOS は、DTA 中の続く 32 バイトに、マッチファイルのディレクトリエントリをコピーします。

検索 FCB が拡張 FCB の場合、呼び出し元 DTA の先頭バイトには FFh がセットされます。 続く 5 バイトはゼロ、そしてアトリビュートとドライブ番号が続く 2 バイトへ、検索 FCB からコピーされます。 そして続く 32 バイトにマッチファイルのディレクトリエントリがコピーされます。 リターン時、呼び出し元 DTA は、検索 FCB と同じアトリビュートを持つ未オープンの拡張 FCB を含んでいます。

アトリビュートバイトがゼロの場合、アトリビュートが何も設定されていない、もしくはリードオンリー、あるいはアーカイブ属性のセットされた、普通のファイルエントリのみを検索します。 ボリュームラベル、サブディレクトリ、ヒドン、システムファイルのエントリは返しません。

アトリビュートバイトがヒドン（ビット 1 をセット）、システムファイル（ビット 2 をセット）、サブディレクトリ（ビット 4 をセット）にセットされた場合、普通のファイルすべてに加え、指定した（複数ビット指定可）アトリビュートにマッチするエントリすべてを検索します。 ボリュームラベルを除くすべてのディレクトリエントリを見るには、アトリビュートバイトのビット 1,2,4 をセットします。

ビット 3 がセットされた場合、ディレクトリエントリのみを検索します。

最初のエントリ検索ファンクションがあいまいファイル名のマッチを発見したあと、次のマッチを本ファンクションで検索できます。 あいまいファイル名は疑問符 ('?') を含むファイル名です。 入力パラメータと戻り値は最初のエントリ検索 (11h) ファンクションと同じです。

マッチするファイルを発見しなかった場合、AL には FFh が返されます。 実際のエラー状況を判別するには、拡張エラーコード取得 (59h) ファンクションを使用してください。

最初のエントリ検索と本ファンクションの間、もしくは本ファンクションを二度実行するその間には、いかなるディスク処理も実行しないでください。 これは DR-DOS が検索 FCB の予約領域に、検索続行に必要な情報を格納しているためです。 検索ファンクションを二度実行する間に入り込んだディスク処理が、この情報を上書きしてしまうでしょう。

（未訳）

（未訳）

（未訳）

（未訳）

（未訳）

現在省略ドライブの番号を返し、ドライブ番号は 0 が A、1 が B、以下同様です。

ディスク転送エリア (DTA) のアドレスを DS:DX で指定されるアドレスにセットします。 DTA をセットしない場合、DR-DOS は、PSP のオフセット 80h に位置した標準 DTA を使います。 （訳注 : この位置にはプログラム起動時のコマンドライン文字列が格納されていますので、標準 DTA を使用した場合、コマンドライン文字列は失われます）

指定したオフセットと DTA セグメント終端の間の領域は、プログラムが利用する最大長のレコードを収納するための、そして DR-DOS がディスク転送を確実に行えるための十分な大きさがあるべきです。 DR-DOS の FCB リードそしてライトのファンクションコール (14h, 15h, 21h, 22h, 27h, 28h) は、DTA セグメント終端を越えた、あるいはセグメントの開始位置をまたいだデータのリードやライトは行いません。

デフォルトドライブについての情報を返します。 ファンクション終了時、DS:BX はデフォルトドライブのファイルアロケーションテーブル (FAT) 識別バイトを指しています。 DX はドライブのクラスタ数を格納しています。 AL はクラスタあたりのセクタ数を格納し、CX は物理セクタのサイズ（バイト数）を格納しています。

DL にドライブ番号が指定されることをのぞいて、ファンクション 1Bh と同じです。 ドライブ番号はゼロで始まり、0 がデフォルトドライブ、1 が A、2 が B、以下同様です。 （訳注 : 手元にある NEC の MS-DOS プログラマーズリファレンスには、AL に FFh が返された場合はエラーだと書いてありました）

（おまけの訳注 : なんでファンクション 1Bh で「クラスタ」なのにこっちで「アロケーションユニット」になっているのだろう。原文でそうなっているので一応こうしときますが。うーん）

ファンクション 32h も参照してください。 このファンクションで DOS DPB のフォーマットを示しています。

（未訳）

（未訳）

（未訳）

（未訳）

呼び出し元プロセスが渡す、割り込み番号 AL の割り込みベクタテーブルを、DS:DX のアドレスにセットします。 割り込みベクタ取得 (35h) の呼び出しによって、割り込みベクタテーブルの内容を調査できます。

（未訳）

（未訳）

（未訳）

（未訳）

システムクロックに記録された曜日、年、月、日を返します。 年を CX に、月を DH に、日 を DL に返します。 すべての戻り値は 2 進数です。 日付計算の際、DR-DOS は月の日数とうるう年かどうかを考慮します。

曜日は 0 から 6 までの番号付けをとっており、日曜日から始まります。 有効年は 1980 年から 2099 年までです。 有効月は 1 から 31 までの数で、該当月の日数と指定年がうるう年かどうかを考慮したものです。

日付クロックが次の日に進むと、日付は自動的に修正されます。

システムの日付を設定します。 入力時、CX には有効な年が、DH には有効な月が、DL には有効な日が入っていなければなりません。

日付の設定に成功した場合は AL に 00h を返し、指定した日付が無効の場合は FFh を返します。

有効年は 1980 年から 2099 年までです。 有効月は 1 から 31 までの数で、該当月の日数と指定年がうるう年かどうかを考慮したものです。

時、分、秒、100 分の 1 秒のシステム時刻を２４時間時計で返します。 4 つの 8 ビット量で時刻を返します。 本ファンクションの戻り値を、プリント可能な書式へ容易に変換、もしくはプログラムがどれだけの間動いているか算出するといった計算目的で使用できます。

２４時間時計でシステム時刻を設定します。 入力時、CH は時、CL は分、DH は秒、DL は 100 分の 1 秒を格納します。 時刻要素に有効でないものがある場合、ファンクション処理は終了し、AL に FFh を返します。 時刻要素が有効で、時刻が正しく設定された場合、AL に 00h を返します。

ベリファイが ON のとき、DR-DOS は現行アプリケーションが行うディスク書き込みをベリファイ（照合）します。 ベリファイフラグの状態取得にはファンクション 54h を使用してください。

ES:BX に現在のディスク転送エリア (DTA) アドレスを返します。 ディスク転送アドレス (DTA) 設定 (1Ah) ファンクションの呼び出しによって DTA アドレスを設定できます。 DTA についての記述は、2.3.4 ディスク転送エリア (DTA) 中にあります。

AL レジスタに DR-DOS バージョン番号の上位部分が、AH レジスタに下位部分が返されます。 BX と CX は 00h に設定されます。 現行バージョンの DR-DOS で返される値は、AL に 03h、AH に 1Fh です。 （訳注 : この項の記述は古いバージョンのもののようです。以下の訳注参照）

（訳注 : この説明を信ずるならば、DR-DOS はバージョンとして 3.31 を返すことになります。 DR-DOS 6 の時代には確かにそうでした。 現行の DR-DOS 7.0 はバージョン番号として AL に 06h、AH に 00h の値を返すはずです。 このファンクションが返す値は SETVER コマンドによりプログラム毎に設定可能です。 SETVER に左右されない真のバージョン番号の取得には真のバージョン番号取得 (3306h) ファンクションを使用してください）

呼び出し元プロセスを終了しますが、DX で示されるパラグラフ数のメモリを残します。 メモリは現在の PSP の先頭から保持されます。

プロセスによってオープンされたファイルは、本ファンクション実行時にはクローズされません。

AL レジスタに渡された二進数のエラーコード（あるいは終了コード）は、子プロセスの終了コード取得 (4Dh) ファンクションを通じて取り出すことができます。

以下の表は DOS ドライブパラメータブロック (DPB) のフォーマットの記述です。

現在の Ctrl-Break チェックの状態を設定もしくは取得できます。 AL レジスタが 00h の場合、Ctrl-Break チェック機構の現在の状態を DL レジスタに返します。 AL に 01h が格納されている場合、Ctrl-Break チェックは DL レジスタに渡される値によって設定されます。

本ファンクションは DOS の内部スタックをまったく使用しませんので、いつでも呼び出すことができます。

本ファンクションは、SETVER コマンドによって設定されたのではない、実際のバージョン番号を返します。 ファンクション 30h を使った場合はそうでなく、戻り値は SETVER で変更可能です。

AL で指定される割り込み番号の、割り込みルーチンアドレスの CS:IP を ES:BX に返します。 割り込みベクタの設定には割り込みベクタ設定 (25h) ファンクションを使用してください。

指定ドライブの空き容量に関する情報を返します。 DL にはドライブ番号を格納し、ドライブ番号は 0 が現在のドライブ、1 が A:、2 が B:、以下同様です。 利用可能なクラスタの数を BX に、ドライブの総クラスタ数を DX に、セクタ当たりのバイト数を CX に、クラスタ当たりのセクタ数を AX に返します。

現在の国コードを、BX レジスタで指定される国コードに変更します。 有効な国コードは以下の通りです。

DS:DX で指定されるメモリブロックに、Figure 4-2 で示される国別情報を返します。 BX レジスタは要求する国を指定します。 国番号 0 は現在の国別情報を返します。

日付フォーマットは以下の通り。

0	M D Y - 米国標準
1	D M Y - ヨーロッパ標準
2	Y M D - 日本標準

通貨形式は以下の通り。

Bit 0	通貨記号が値より前にある場合、0
	通貨記号が値の後ろにある場合、1
Bit 1	通貨記号と値の間に空白がない場合、0
	通貨記号と値の間に空白がひとつある場合、1

時刻形式は以下の通り。

Bit 0	12 時間時計の場合、0
	24 時間時計の場合、1

大文字変換呼び出しでは AL レジスタを以下のように利用します。

入力時の AL	大文字に変換する 80h 以上の ASCII コード
出力時の AL	大文字に変換された ASCII コード

キャリーフラグがセットされている場合、AX レジスタはリターン時のエラーコードを格納しています。 エラーコードの定義については Chapter 5 を参照してください。

DS:DX で示される ASCIZ 文字列でドライブとパス名を指定します。 指定したパスの最深部に新しいディレクトリを作成し、呼び出し元プロセスに戻ります。 指定したパスのディレクトリが存在しない場合、ディレクトリ構造に新しいディレクトリを作成はしません。 （訳注 : つまり、たとえば C:\foo\bar というディレクトリを作成する時に C:\foo ディレクトリが存在しない場合、本ファンクションは失敗します。このような場合、まず C:\foo ディレクトリを作成し、次に C:\foo\bar を作成、というようにファンクションを二度にわけて実行することになります） 本ファンクションは AX レジスタにエラーコード 3 もしくは 5 を返します。 エラーコードの定義については Chapter 5 を参照してください。

DS:DX レジスタで示される ASCIZ 文字列のディレクトリを、ディレクトリ構造から削除します。 カレントディレクトリは削除できません。

削除されるディレクトリが空でない、もしくはいずれかのプロセスによるアクセス状態である場合はエラーコード 5 を返します。 ASCIZ 文字列が無効なパスを指定している場合はエラーコード 3 を返します。

DS:DX で示される ASCIZ 文字列に、カレントディレクトリを設定します。 指定パスのディレクトリが存在しない場合、キャリーフラグをセットし、エラーコード 3（パスが見つからない）を AX レジスタに返します。

新しいファイルを作成します。 指定された名前のファイルがすでにある場合、書き込み処理以前にファイル長は 0 に切り詰められます。 ファイルが存在しない場合、ASCIZ 文字列で指示されるディレクトリにファイルを作成し、ファイル属性を与えます（2.3.3 ファイルアトリビュートバイトを参照）。 AX レジスタにファイルのハンドルを返します。

キャリーフラグがセットされている場合、本ファンクションは AX レジスタにエラーコード 3, 4, もしくは 5 を返します。 エラーコード 5 アクセス拒否 (Access Denied) は指定ディレクトリが満杯、もしくは同じ名前のファイルが存在し、そのファイルにリードオンリー指定がされていることを示しています。 エラーコードの定義に関しては Chapter 5 を参照してください。 ファイルアトリビュートの変更にファイルモード変更 (43h) が使えることに注目してください。

ASCIZ で指定されたディレクトリと名前を持つファイルを開きます。 通常ファイルもヒドン（隠し）ファイルも開くことができます。 デバイス名はコロン (':') で終了しません。

入力時、DS:DX はオープンするファイルのドライブ、パス、ファイル名を含む ASCIZ 文字列を指定します。 AL レジスタはファイルがオープンされるモードを定義します。

リターン時、キャリーフラグがセットされていない場合、以降のリード／ライト処理に使うことになる 16 ビットのファイルハンドルが返されます。 キャリーフラグがセットされている場合、AX に拡張エラーコードが返され、ファンクションコールの失敗理由が示されます。 拡張エラーコードは以下のいずれかひとつです。

• エラーコード 2 -- ファイルが見つからない
• エラーコード 4 -- ファイルハンドルがない（オープンしているファイルが多すぎる）
• エラーコード 5 -- アクセス拒否
• エラーコード 12 -- 無効なアクセスコード

ファンクションが成功した場合、ファイルのリード／ライトポインタをファイル先頭バイトにセットし、ファイルのレコードサイズを 1 バイトにセットします。 ファイルポインタ移動（シーク） (42h) でポインタを移動できます。 ファイルモード変更 (43h) でファイルアトリビュートの取得や設定ができます。 ファイルアトリビュートは 2.3.3 ファイルアトリビュートバイトにて説明しています。

入力時、AL レジスタに与えられるコンビネーション値によって、ファイルアクセスの広範な制御を行います。 アクセスコードは AL 内で 4 つのフィールドにわけて定義されています。 インヘリタンス（継承）フラグ（1 ビット）、シェアリング（共有）モード（3 ビット）、予約フィールド（1 ビット）、そしてアクセスフィールド（3 ビット）です。

インヘリタンスフラグ (I : bit 7) は、ファイル（ハンドル）がプライベート (I=1) かどうか、もしくは子プロセスにも引き継がれる (I=0) かどうかを指示します。

アクセスフィールド (A : bit 2-0) は、ファイルに行われうる操作を、以下の３つのうちのひとつの指定通りに制限します。

• 00h -- リードのみのためにオープン
• 01h -- ライトのみのためにオープン
• 02h -- リードとライトのためにオープン

シェアリングモード制御 (S : bit 6-4) は、ファイルがオープンしている間、他のプロセスが所持するそのファイルへのアクセス権を制御し、以下の 5 つのうちのひとつに従います。

• 000 -- コンパチビリティ（互換）
• 001 -- リード／ライト拒否
• 010 -- ライト拒否
• 011 -- リード拒否
• 100 -- 拒否なし

上記の 3 ビットを使えるようにするには SHARE がロードされていなければならないことに注意してください。 （やや無責任な訳注 : SHARE.EXE が常駐しているかどうかは INT 2Fh, AX=1000h で調べることができます。AX に 1000h を入れて INT 2Fh を実行し、AL に FFh が返ってきた場合、SHARE がインストールされています。詳しいことは Interrupt List あたりで調べてください）

ファイル共有には、関係する全プロセス間での厳密な協調操作が要求されます。 もしいずれかのプロセスが何らかのアクセスレベルを拒否するモードでファイルをオープンした場合、他のプロセスによるそれ以降の、そのアクセスレベルを必要とするファイルオープン要求は失敗します。 そのうえ、すでに他のプロセスでうまくいっているシェアリングモードでファイルをオープンしようとしても、必ず失敗してしまいます。

シェアリングモードつきでファイルをオープンすることの影響を肝に銘じておくべきでしょう。 特に、ファンクションが失敗する原因となる以下のような状況に注意してください。

• ファイルがすでにコンパチビリティモードでオープンしている
• ファイルがすでにリード／ライト拒否モードでオープンしている
• ライト拒否で、ライトもしくはリード／ライトアクセスを要求
• リード拒否で、リードもしくはリード／ライトアクセスを要求

拒否なしシェアリングモードは他プロセスへの制限をまったくかけません。

（訳注 : ファイルシェアリングモードについての説明が個人的にいまいちわからなかったので、MS-DOS 方面のマニュアルだのを見てみると、だいたい以下のような感じでした。

• コンパチビリティ（互換）モードは要するに、ネットワーク未対応だった DOS バージョン 2.x 時代と互換性のあるモードである。 このモードでオープンされているファイルは、それ以外の（「拒否なし」も含む）シェアリングモードでオープンできない。
• 同様に、コンパチビリティ以外の（「拒否なし」も含む）モードでオープンされているファイルは、コンパチビリティモードでオープンできない。
• ただし、ファイルアクセスフィールドが「リードのみのためのオープン」になっている場合、コンパチビリティモードでのファイルオープンは「ライト拒否」と同等だと見なされる。 つまりコンパチビリティモードでも、リードオンリーモードでオープンすればファイルの共有が可能である。
• リード／ライト拒否モードでオープンされているファイルは、そのファイルハンドルがクローズされない限り、どのシェアリングモードでもオープンできない。 また、すでに別のシェアリングモードでオープンされているファイルをリード／ライト拒否モードでオープンした場合、先にオープンしたプロセスもそのファイルに対してリード／ライトができなくなる。

指定されたファイルハンドルをクローズし、そのファイルに関連する内部バッファの内容をディスクに書き出し、ディレクトリを更新します。 キャリーフラグがセットされている場合、無効なファイルハンドルが指定されていることを示すエラーコード 6 を AX レジスタに返します。

CX で指定されるバイト数を、ファイルから、DS;DX で示されるバッファに転送します。 リターン時、キャリーフラグがセットされている場合、AX はエラーコード 5 もしくは 6 を格納しています。 エラーコードの定義は Chapter 5 を参照してください。

ファンクションコールが成功した場合、キャリーフラグはセットされず、AX はファイルもしくはデバイスから読み込んだバイト数を格納しています。 ファンクションコールがデバイスからの読み込みに使われた場合、CX で指定されるより少ないバイト数が読み込まれるように、デバイスの能力に制限がかけられます。

ファイルからの読み込みの時、AX の値が CX で指定された値より小さい場合は、プログラムがファイルの終端 (EOF) まで読み上げたことを示しています。 値 0 はファイル終端から読みはじめようとしたことを示しています。

（念のための訳注 : つまりエラーなしでファンクションが終了し、AX < CX の場合、もし読み込んでいたのが正しくファイルからなら、ファイルの終わりまで読み込んだことになります。 しかし、たとえば標準入力などのキャラクタデバイスからだった場合、必ずしも入力がそこで全部終わったとは限りません。 たとえばキーボード入力を読み込む場合、改行入力があった時点でファンクションは終了し、AX にはその時点までの文字数が返されることになります。 継続入力が本当にないか調べるには、たぶんもう一度ファイルリードを発行し、AX が 0 か（もしくはエラーか）どうか調べる必要があるでしょう。 もっとも、ファイル相手でもそうした方がいいような気もしますが… ）

DS:DX で示されるバッファから、CX で指定されるバイト数を、BX で示されるファイルハンドルに転送します。

リターン時、キャリーフラグがセットされていた場合、AX にエラーコード 5 もしくは 6 を返します。 エラーコード 5 はアクセス拒否を示し、エラーコード 6 は無効なファイルハンドルを示します。 キャリーフラグがセットされていない場合、実際に書き込んだバイト数を AX に返します。 （訳注 : AX と CX の値が異なる場合、ディスクフルの可能性があります。 MS-DOS 方面の文献によると、ディスクフル時にキャリーフラグはセットされません。 DR-DOS でもおそらくそうなんでしょう） CX レジスタが 0 の場合、ファイルは、現在のファイルポインタの位置に切り詰められます。 （訳注 : ファイルポインタがファイル終端よりも後方にある時に CX = 0 でファイルライトを行った場合、ファイルサイズがその地点まで伸ばされます。 ファイルポインタ移動 (42h) も参照のこと）

ファイル名に結び付いたディレクトリエントリを削除します。 DS:DX で示される ASCIZ 文字列のいかなる部分にも、疑問符 ('?') とアスタリスク ('*') のワイルドカード文字は使えません。

リードオンリーファイルは削除できません。 リードオンリーファイルを削除するには、まずファイルモード変更 (43h) ファンクションを使用してファイルアトリビュートを変更しなければなりません。

リターン時、キャリーフラグがセットされている場合、ファイルが見つからない、もしくはアクセス拒否を示すエラーコード 2 もしくは 5 を AX に返します。

AL に渡された値で指定した方法により、リード／ライトポインタを移動します。 入力時、CX:DX にはポインタの移動距離を格納します。 リターン時にキャリーフラグがセットされていない場合、DX:AX は新しいポインタ位置を格納しています。 DX が値の上位部分を格納しています。 キャリーフラグがセットされている場合、AX にエラーコード 1 もしくは 6 を返します。 エラーコードの定義は Chapter 5 を参照してください。

AL レジスタには以下の値のうちひとつをセットしてください。

本ファンクションは：

• ASCIZ 文字列で指定されるファイルのアトリビュートを取得、もしくは設定します。
• ファイルのパスワードモードを取得、もしくは設定し、新規パスワードを割り当てます。

入力時に AL が 1 の場合、ファイルアトリビュートを CX で指定されるものに変更します。 リターン時、AL に 0 が格納され、なおかつキャリーフラグがセットされていない場合、現在のファイルアトリビュートが CX に返されます。 DOS のファイルアトリビュートバイトは 2.3.3 ファイルアトリビュートバイトにて記述されています。

キャリーフラグがセットされている場合、AX に 2、3、もしくは 5 を返します。 エラーコードの定義に関しては Chapter 5 を参照してください。

●デバイス入出力制御 (IOCTL) (44h)
Device I/O Control

キャラクタデバイスやブロックデバイスからの入出力情報を取得、もしくは設定します。 行われる処理は、入力時に AL レジスタに与えられる内容に依存します。

各処理の入力および戻り値の完全な記述は Appendix A. デバイス入出力制御(IOCTL) 中にあります。

入力時に BX に格納されたファイルハンドルの複写を返します。 複写したハンドルを使って、クローズと再オープンのオーバヘッドなしにファイルのディレクトリエントリを更新できます。 一例として、複写したハンドルのファイルクローズ (3Eh) はバッファフラッシュとディレクトリエントリ更新を発生させ、その一方で元のファイルハンドルは読み書きオープン状態を維持しています。 複写ハンドルは同じディレクトリの、同じファイルに連動しています。 どちらかのハンドルのリード／ライトポインタをファイルリード (3Fh)、ファイルライト (40h)、ファイルポインタ移動（シーク） (42h) で動かした場合、もう一方のファイルハンドルのポインタも移動します。

リターン時、キャリーフラグがセットされていた場合、AX にエラーコード 4 もしくは 6 を返します。 エラーコード 4（ファイルハンドル不足）はオープンされているファイル数がシステムの制限を超えたことを示します。 エラーコード 6 は無効なファイルハンドルを示します。

CX のファイルハンドルを、BX に格納されるハンドルと同じファイルに強制的に関連付けます。 CX に渡された、すでに存在するファイルハンドルがオープンしたファイルに関連付けられている場合、本ンファンクションは強制二重化を行う前にそのファイルをクローズします。 どちらかのハンドルのリード／ライトポインタをファイルリード (3Fh)、ファイルライト (40h)、ファイルポインタ移動（シーク） (42h) で動かした場合、もう一方のファイルハンドルのポインタも移動します。

本ファンクションは入出力のリダイレクトに使用できます。

（訳注 : なんかいまいちうまく訳せなかったので、罪滅ぼしもかねて、標準出力をリダイレクトする手順を例として書いてみます。

1. リダイレクト先のファイルをオープン、もしくは作成。
2. 標準出力のハンドル (1) を複製し、複製したハンドルを保存しておく。
3. BX にリダイレクト先ファイルの、CX に標準出力の (1) ハンドルを入れ、強制二重化ファンクション実行
4. この時点で標準出力はリダイレクトされている。 標準出力ハンドルへの書き込みはリダイレクト先ファイルに出力される。
5. リダイレクトの必要がなくなったら標準入力を元に戻す。 BX に 2. で保存しておいたハンドル、CX に標準出力 (1) のハンドルを入れ、強制二重化ファンクション実行。
6. リダイレクト先のファイルハンドルと、2. で保存しておいたハンドルをクローズ。

DL で指定されたドライブのカレントディレクトリのフルパス名を、DS:SI で示される 64 バイトのユーザメモリに書き込みます。 パス名には、ドライブ名や先頭のバックスラッシュ（円記号）を含まず、00h で終わります。

DL が正しいドライブ番号を含まない場合、キャリーフラグをセットし、エラーコード 15（無効なドライブ指定）を AX レジスタに返します。

要求されたパラグラフ（16 バイト）数のメモリを割り当てます。 BX は要求パラグラフ数を格納します。

リターン時、ファンクションコールが成功した場合、AX は割り当てたメモリブロックのポインタを格納しています。 失敗した場合、AX はエラーコード 7 もしくは 8 を格納し、BX は使用可能なメモリの最大サイズをパラグラフ単位で格納します。

エラーコードの定義については Chapter 5 を参照してください。

指定メモリを開放して、再割り当てできるようにします。 入力時、ES は開放しようとするメモリブロックのセグメントアドレスを格納します。

戻り値はありません。 キャリーフラグがセットされている場合、エラーコード 7 もしくは 9 を AX に返します。 エラーコードの定義については Chapter 5 を参照してください。

メモリブロック配置を、指定のサイズに変更します。 入力時、ES は割当済みメモリブロックのセグメントアドレスを格納し、BX は要求するメモリブロックサイズをパラグラフ（16 バイト）単位で格納します。 DR-DOS は BX の内容にしたがい、割り当て済みメモリブロックのサイズを増加、もしくは減少させます。

DR-DOS が割当済みブロックのサイズを大きくできない場合、サイズ変更可能な最大ブロックサイズを BX に返します。 キャリーフラグがセットされている場合、エラーコード 7, 8 もしくは 9 を AX に返します。 エラーコードの定義については Chapter 5 を参照してください。

（訳注 : BX のパラグラフ数だけ増減するのではなく、BX のパラグラフ数そのものに変更する、という点に注意してください。 また、Ｃ言語ライブラリの realloc などと異なり、メモリブロックの起点は移動されません。 したがって、たとえばサイズ変更するメモリブロックの直後のメモリがすでに割り当てられている場合、他の位置に空きメモリがどれだけあってもサイズ増加は失敗します。 ）

DS:DX で示される ASCIZ 文字列は、ロードするファイルの名前とファイル型（訳注 : たぶん拡張子のことだと思う）を含んでいなければなりません。 ドライブとパスは任意です。 （訳注 : 環境変数 PATH によるファイルサーチは行いませんので、カレントディレクトリ以外のプログラムを実行する場合はパスを指定する必要があるでしょう）

DR-DOS は使用可能なメモリをすべて現在のプログラムに割り当ててしまっているため、ファイルのロードにじゅうぶんなだけのメモリを開放しなければなりません。 本ファンクション実行の前に、割当メモリサイズ変更 (4Ah) ファンクションを使用して、割り当てメモリを現行プログラムの最低要求量に減らしてください。

ES:BX で指定されるロードパラメータブロック (LPB) のフォーマットは、それを使うファンクションの型に依存します。 Figure 4-3 と 4-5 を参照してください。

キャリーフラグをセットして処理を戻した場合、AX レジスタは以下の値 1, 2, 7, 8, 10 もしくは 11 を格納しています。 エラーコードの定義については Chapter 5 を参照してください。

プログラムのロードと実行 (AL = 00h)

入力時に AL が 00h の場合、プログラムセグメントのオフセット 0 に PSP を作成し、それに続いて、終了アドレスフィールドと Ctrl-Break アドレスフィールドのセットを司令します。 そして、プログラムセグメントのオフセット 100h に ASCIZ 文字列で示されるプログラムをロードし、制御を移します。 リターン時、全レジスタは変更されています。 スタックセグメント、スタックレジスタ、そして値の保存が必要なその他のレジスタを復元しなければなりません。

プログラムは、以下の 5 つのうちのひとつの方法で戻ることができます。

• AH に 4Ch をセットして INT 21h 発行。 これが望ましい方法。
• PSP のオフセット 0 にジャンプ。
• INT 20h 発行。
• AH に 00h をセットして INT 21h 実行。
• AH を 4Ch にして PSP のオフセット 50h をコール。

本ファンクションを呼び出したプロセスが制御を取り戻したとき、割り込みベクタ 22h, 23h, 24h は、子プロセス PSP の終了アドレス、Ctrl-Break アドレス、致命的エラーフィールドの値から戻されます。

親プロセスがインヘリタンスビットをゼロにしてオープンしたファイルハンドルはすべて、本ファンクションが作成した子プロセスのために複製されます。 （訳注 : ファイルオープンの説明参照） 新プロセスは、標準入力、標準出力、プリンタ、補助デバイスを呼び出し元プロセスから受けつぎます。 子プロセスはまた、呼び出し元プロセスのテキスト文字列、もしくは「環境」も受けつぎます。 LPB 中の環境セグメントフィールド（オフセット 00h）の値が 0000h の場合、子プロセスは環境をそのまま受けつぎます。 環境がいつでもパラグラフ（16 バイト）境界で配置されることに注意してください。

Figure 4-4 は環境文字列のフォーマットを図示しています。

（訳注 : 最後の 00h の直後に、01h、00h の２バイトが続き、さらにその後にプログラムのパス名が ASCIZ 文字列で格納されています。 Ｃ言語で言うところの argv[0] に相当します。 ）

オーバレイのロード (AL = 03h)

入力時に呼び出し元プロセスが AL に 03h を渡した場合、DR-DOS は ASCIZ 文字列で示されるプログラムをロードしますが、PSP の設定やプログラムの実行開始を行いません。 Figure 4-5 の記述にある LPB によって指定されたセグメントに、プログラムをロードします。 プログラムのオーバレイ（上書き）ロードにはこのファンクションを使用してください。 （訳注 : ファンクション 4B00h と異なり、オーバレイロードは、割当済みメモリへのロードを前提にしています。 したがって、ロードするプログラムの使用メモリサイズを正しく把握しておく必要があります。 ロードしたプログラムが、あらかじめ割り当てておいたサイズ以上のメモリを使用した場合、システム破壊の恐れがあります。 ） Figure 4-6 は PSP を図示しています。

Table 4-3 は LPB フィールドの定義です。

（訳注 : オーバレイロードするファイルが、たとえば .COM ファイルのようなベタのバイナリの場合、ファイルがオーバレイセグメントの位置からそのまま読み込まれ、セグメントリロケーションの補正は行われないので、リロケーションファクタは 0000h でかまいません。 ファイルが EXE 形式の場合、EXE ファイルのリロケーションテーブル中にあるセグメントアドレスを、実際にロードしたアドレスにあわせて補正します。 基本的には、リロケーションファクタにオーバレイセグメントと同じ値を設定します。 ）

プログラムをメモリにロードし、新しい PSP を作成しますが、新しいプログラムに制御を移しません。

（訳注 : LPB は Table 4-3 と同じ）

新規プログラムの実行準備をします。 これには SETVER コマンドで指定される DR-DOS バージョン番号の設定が含まれます。

本ファンクションは、ファンクション 4B00h を横取りするプログラムで必要とされます。 リターン時、呼び出し元プログラムは可能な限り早く新規プログラムに制御を移さねばなりません。 新規プログラム起動の前に、DOS、BIOS その他のいかなるソフトウェア割り込みも呼び出してはなりません。

DR-DOS が HMA で動作している場合、A20 ラインは HMA をアクセス不可にするため OFF にされます。

現在のプロセスを終了し、プログラムのロードと実行 (4Bh) ファンクションを呼び出したプロセスに制御を戻します。 現在のプロセスがオープンしたファイルハンドルはすべてクローズします。 本ファンクションを呼び出すプロセスは、ファンクション実行の前に、AL レジスタに二進数の終了コードを渡すことができます。 そのとき親プロセスは、子プロセスの終了コード取得 (4Dh) ファンクションを通じて、終了コードを取り出すことができます。

別プロセスのキーププロセス (31h) もしくはプロセス終了 (4Ch) で指定された二進数の終了コード、もしくは完了コードを返します。 AX レジスタの下位バイトはプロセスの終了によって指定された終了コードを格納します。 上位バイトは以下の値のうちのひとつを返します。

• 00h -- 通常終了
• 01h -- Ctrl-Break による終了
• 02h -- 致命的エラーによる終了
• 03h -- キーププロセス (31h)

入力時に DS:DX が指す ASCIZ 文字列で指定されたファイル名にマッチする、最初のファイルを探します。 ASCIZ 文字列はマッチさせるドライブ、パス、ファイル名を格納します。 ASCIZ 文字列のファイル名の位置には疑問符 ('?') を含めることもでき、疑問符はファイル名の同位置にあるどの文字ともマッチします。 （訳注 : アスタリスク * も使えます。）

CX レジスタは、検索に含めるファイルを指定するファイルアトリビュートを格納します。 検索時のファイルアトリビュートバイトの用法は最初のエントリ検索 (11h) 中で説明しています。 マッチするファイルが見つかった場合、呼び出し元プログラムの DTA に以下の情報を置きます。

リターン時、キャリーフラグがセットされている場合、AX はエラーコード 2 もしくは 18 を格納しています。 エラーコード 2 はファイルが見つからないことを示します。 エラーコード 18 は、疑問符 ('?') を使用したときにマッチするファイルが見つからなかったことを示します。

それ以前の最初のファイル検索 (4Eh) もしくは 次のファイル検索 (4Fh) ファンクションで指定されたファイル名にマッチする、次のファイルを探します。 入力時、DTA は以前の最初のファイル検索 (4Eh) ファンクションが供給した情報を格納していなければなりません。

マッチするファイルが見つかった場合、呼び出し元プログラムの DTA を最初のファイル検索で上述したように設定します。 さらなるマッチファイルが見つからない場合、エラーコード 18（マッチするファイルがもうない）を AX に返します。

ベリファイフラグの値を返します。 ベリファイが ON の場合 AL に 01h を、ベリファイが OFF の場合 00h を返します。

DS:DX が指す ASCIZ 文字列を使うことによって指定されるファイルをリネームし、文字列にはドライブ、パス、ファイル名を格納します。 ES:DI で渡される文字列は、パスと新しいファイル名を格納します。 二番目の (ES:DI) ASCIZ 文字列でドライブが指定されている場合、最初の (DS:DX) 文字列中で指定したものと同じでなければなりません。 リターン時にキャリーフラグがセットされている場合、AX はエラーコード 3, 5 もしくは 17 を格納しています。 エラーコードの定義は Chapter 5 を参照してください。

（念のための訳注 : 変更前のディレクトリと変更後のディレクトリが異なり、変更後のディレクトリがすでに存在する場合、ファイルは変更後のディレクトリに移動します。 つまり本ファンクションは、ファイルの名前変更とファイル移動を一度に行うことができます。 物理ドライブが異なる場合は自力でコピーしないといけないのですが… ）

ファイルが最後に変更された日付と時刻を取得、もしくは設定します。 入力時に AL が 01h を格納している場合、ファイルの時刻と日付を CX と DX に格納された値に設定します。 入力時に AL が 00h を格納している場合、ファイルの時刻と日付を CX と DX に返します。 日付と時刻のフォーマットは DOS ディレクトリエントリのためのフォーマットと同じものです。 （訳注 : このあとにフォーマットの説明があるのですが、ようするに標準 FCB で説明されている TIME フィールドや DATE フィールドと同じなので省略。 スマンス）

リターン時にキャリーフラグがセットされている場合、AX はエラーコード 1 もしくは 6 を格納しています。 エラーコードの定義に関しては Chapter 5 を参照してください。

（訳注 : うーん、いちおう訳注かましておいたほうがいいんでしょうか。 まあいいや。 アロケーションストラテジというのは要するに、メモリ割り当て要求が DOS に対して出されたとき、どういう方法で DOS が空きメモリを探すのかという方法です。 例として 00h から 02h までを説明すれば、

値	ストラテジ	説明
00h	first fit	メモリの空き領域を、コンベンショナル（基本）メモリの下位から上位の順で探し、要求されたサイズよりも大きい空き領域があった時点で、そこを確保する。
01h	best fit	基本メモリ中の空き領域をすべて調べ、要求されたメモリサイズにもっとも近い（そして大きい）空き領域を確保する。
02h	last fit	要求されたサイズよりも大きい基本メモリ中の空き領域のうち、もっとも上位のアドレスにメモリブロックを確保する。

こんな感じでしょうか。
ストラテジの値が 40h〜42h の場合、UMB 内部のみを調べます。 80h〜82h の場合、まず UMB 内部を調べ、UMB 内部にメモリ割り当てができないときは基本メモリ内を調べます。 ）

キャリーフラグをセットしてエラーを返す INT 21h ファンクションコール、INT 24h エラーハンドラ、そして AL レジスタに FFh を返す FCB ファンクションコールから、さらに多くのエラー情報を得るために、本ファンクションを呼び出すことができます。 DX, SI, DI, ES, CL, DS レジスタの内容はリターン時に破壊されます。

エラークラス

BH レジスタの内容は、エラータイプの詳細を示します。

レスポンス

エラー状況に対する推奨対応は、BL に以下のように示されます。

リソース

以下の値は CH に格納され、エラーの要因となった物理リソースの詳細を示します。

与えられたパスの最後に固有のファイル名を追加し、そのファイル作成を作成します。 そのファイルがすでに存在する場合、新しいファイル名が作成され、処理が繰り返されます。 ファイルはリード／ライトアクセスのコンパチビリティモードでオープンされます。 ファイルは、プログラム終了時に自動的に削除されません。

（訳注 : 入力時に DS:DX で、一時ファイルを作成するパスを ASCIZ 文字列で指定します。 このとき ASCIZ 文字列にファイル名は含まず、円記号 ('\')、00h で終わらせます。 ファンクションが成功した場合、DS:DX で指定したパスの後ろに、DOS が作成したファイル名が追加されます。 したがって、入力時の DS:DX で指定される ASCIZ パスの後方には、ファイル名を格納する空き領域が必要です。 MS-DOS のリファレンスによると、ASCIZ パス終端の 00h の後ろに、さらに 13 バイトの領域が必要だそうです。 ）

ファイル名がすでに存在する場合に失敗することを除いて、ファイル作成 (3Ch) と同じです。 ファイルはリード／ライトアクセスのコンパチビリティモードでオープンされます。

本ファンクションはリード拒否、もしくは拒否なしシェアリングモードでのみ使用されます。 限られた時間、他のプロセスがファイル領域にリード／ライトアクセスすることを拒否する、簡単な方法を提供します。 領域はファイルのどの地点にも設定できますが、本ファンクションが短時間のあいだに渡ってのみ使用されることを推奨します。 （訳注 : 要するに、ロックした領域はなるたけ早めにアンロックしなさい、ということらしいです。 ）

Note : SHARE がロードされていない場合、エラー 1（無効なファンクションコール）が返されます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

（未訳）

Note : 本ファンクションコールは、ネットワークプログラムがロードされている場合のみサポートされます。

国コードとコードページは、正しい組み合わせでなければなりません。 そうでない場合は AX レジスタにエラーコード 2（ファイルが見つからない）が返されます。 CX で要求された分よりも多くの情報が提供される場合、エラーが出ることはなく、情報は切り詰められます。 AL の値は、提供する情報を確定します。

デフォルトの国コードとコードページの情報以外のものを取得するには NLSFUNC のロードが必要なことに注意してください。

Figure 4-9 は、AL が 01h のときの国別情報テーブルの格納結果を図示しています。

AL が 02h のとき、結果は、1 バイトのファンクション ID (01h)、それに続いて大文字テーブルを指す 4 バイトダブルワードポインタです。 大文字テーブルは、テーブル長を表す 2 バイトのフィールド、それに続いて ASCII 文字を大文字化した値を格納した 128 バイトのテーブルです。

AL が 04h のとき、結果は、1 バイトのファンクション ID (04h)、それに続いてファイル名大文字テーブルを指す 4 バイトダブルワードポインタです。 ファイル名大文字テーブルは、テーブル長を表す 2 バイトのフィールド、それに続いて ASCII 文字を大文字化した値を格納した 128 バイトのテーブルです。

AL が 05h のとき、その国コードとコードページのためのファイル文字テーブルのアドレスを返します。

AL が 06h のとき、結果は、1 バイトのファンクション ID (06h)、それに続いて照合順列テーブルを指す 4 バイトのダブルワードポインタです。 照合順列テーブルは、テーブル長を表す 2 バイトのフィールド、それに続いて（訳注 : ソートの）順番に置かれた 256 個の ASCII 値テーブルです。

AL が 07h のとき、結果は、ダブルバイト文字セット (DBCS) テーブルを指す 4 バイトのダブルワードポインタです。 DBCS テーブルのフォーマットは Figure 4-10 に図示しています。 テーブルの各エントリはダブルバイト文字の先頭バイトになりうる文字コードの範囲を示しています。

たとえば、コードページ 932、国コード 81（日本）の DBCS テーブルは以下のようになります。

81h から 9Fh の中に含まれる、もしくは E0h から FCh の中に含まれる値は、有効な漢字先導バイト (lead byte) であり、それは、DBCS 文字の先頭バイトです。

本ファンクションは、グローバルコードページ設定時、正しいコードページデータを COUNTRY.SYS から読み出し、国情報データ領域に配置します。 新コードページの SELECT コマンド（訳注 : Appendix A 参照。ってまだ訳してないけど）はそのとき、コードページ切り替えをサポートするすべてのデバイス（ドライバ）で実行されます。 デバイスは CONFIG.SYS 中での定義によって決定されます。

デバイスが SELECT コマンドの実行に失敗した場合、AX にエラーコード 65h を返し、キャリーフラグがセットされます。

コードページが現在の国コードで有効ではない場合、もしくは COUNTRY.SYS ファイルがオープンできない、読み込めない場合、AX にエラーコード 02h を返し、キャリーフラグがセットされます。

Note : グローバルコードページの変更するには、NLSFUNC がロードされていなければなりません。

プロセスがオープンを許可するファイルハンドルの最大数を変更するために用いられます。 拡張されたハンドルリストを格納するため、割当メモリサイズ変更 (4Ah) ファンクションを使用して、余分なメモリを開放しておかねばなりません。

ハンドル要求数が 20 未満の場合、要求数は 20 に切り上げられます。

オープンされているファイルのディレクトリエントリを更新し、そのファイルに関連するデータバッファと FAT バッファをフラッシュします。 ファイルをクローズして再オープンするのと同様の効果がありますが、本ファンクションは、たとえばマルチユーザ・ネットワーク環境での、より確実なファイル変更法を提供します。