Turbo C 2.0 函数中文说明大全(四)

接口子程序,所在函数库为:dos.h、bios.h
unsigned sleep(unsigned seconds) 暂停seconds微秒(百分之一秒)
int unlink(char *filename) 删除文件filename
unsigned FP_OFF(void far *farptr) 本函数用来取远指针farptr的偏移量
unsigned FP_SEG(void far *farptr) 本函数用来没置远指针farptr的段值
void far *MK_FP(unsigned seg,unsigned off)根据段seg和偏移量off构造一个far指针
unsigned getpsp() 取程序段前缀的段地址,并返回这个地址
char *parsfnm(char *cmdline,struct fcb *fcbptr,int option)
函数分析一个字符串,通常,对一个文件名来说,是由cmdline所指的一个命令行.
文件名是放入一个FCB中作为一个驱动器,文件名和扩展名.FCB是由fcbptr所指定的.
option参数是DOS分析系统调用时,AL文本的值.
int absread(int drive,int nsects,int sectno,void *buffer)
本函数功能为读特定的磁盘扇区,
drive为驱动器号(0=A,1=B等),nsects为要读的扇区数,sectno为开始的逻辑扇区号,buffer为保存所读数据的保存空间
int abswrite(int drive,int nsects,int sectno,void *buffer)
本函数功能为写特定的磁盘扇区,
drive为驱动器号(0=A,1=B等),nsects为要写的扇区数,sectno为开始的逻辑扇区号,buffer为保存所写数据的所在空间
void getdfree(int drive,struct dfree *dfreep)
本函数用来取磁盘的自由空间,
drive为磁盘号(0=当前,1=A等).函数将磁盘特性的由dfreep指向的dfree结构中. dfree结构如下:
┌───────────────────┐
│struct dfree │
│{ │
│ unsigned df_avail; /*有用簇个数*/ │
│ unsigned df_total; /*总共簇个数*/ │
│ unsigned df_bsec; /*每个扇区字节数*/│
│ unsigned df_sclus; /*每个簇扇区数*/ │
│} │
└───────────────────┘
char far *getdta() 取磁盘转换地址DTA
void setdta(char far *dta) 设置磁盘转换地址DTA
void getfat(int drive,fatinfo *fatblkp)
本函数返回指定驱动器drive(0=当前,1=A,2=B等)的文件分配表信息并存入结构fatblkp中,结构如下:
┌──────────────────┐
│struct fatinfo │
│{ │
│ char fi_sclus; /*每个簇扇区数*/ │
│ char fi_fatid; /*文件分配表字节数*/│
│ int fi_nclus; /*簇的数目*/ │
│ int fi_bysec; /*每个扇区字节数*/ │
│} │
└──────────────────┘
void getfatd(struct fatinfo *fatblkp) 本函数返回当前驱动器的文件分配表信息, 并存入结构fatblkp中,结构如下:
┌──────────────────┐
│struct fatinfo │
│{ │
│ char fi_sclus; /*每个簇扇区数*/ │
│ char fi_fatid; /*文件分配表字节数*/│
│ int fi_nclus; /*簇的数目*/ │
│ int fi_bysec; /*每个扇区字节数*/ │
│} │
└──────────────────┘
int bdos(int dosfun,unsigned dosdx,unsigned dosal)
本函数对MSDOS系统进行调用, dosdx为寄存器dx的值,dosal为寄存器al的值,dosfun为功能号
int bdosptr(int dosfun,void *argument,unsiigned dosal)
本函数对MSDOS系统进行调用,
argument为寄存器dx的值,dosal为寄存器al的值,dosfun为功能号
int int86(int intr_num,union REGS *inregs,union REGS *outregs)
执行intr_num号中断,用户定义的寄存器值存于结构inregs中, 执行完后将返回的寄存器值存于结构outregs中.
int int86x(int intr_num,union REGS *inregs,union REGS *outregs, struct SREGS *segregs)
执行intr_num号中断,用户定义的寄存器值存于结构inregs中和结构segregs中,执行完后将返回的寄存器值存于结构outregs中.
int intdos(union REGS *inregs,union REGS *outregs)
本函数执行DOS中断0×21来调用一个指定的DOS函数,用户定义的寄存器值存于结构inregs中,执行完后函数将返回的寄存器值存于结构outregs中
int intdosx(union REGS *inregs,union REGS *outregs,struct SREGS *segregs)
本函数执行DOS中断0×21来调用一个指定的DOS函数,用户定义的寄存器值存于结构inregs和segregs中,执行完后函数将返回的寄存器值存于结构outregs中
void intr(int intr_num,struct REGPACK *preg)
本函数中一个备用的8086软件中断接口它能产生一个由参数intr_num指定的8086软件中断.
函数在执行软件中断前, 从结构preg复制用户定义的各寄存器值到各个寄存器.软件中断完成后,
函数将当前各个寄存器的值复制到结构preg中.参数如下:
intr_num 被执行的中断号，preg为保存用户定义的寄存器值的结构,结构如下
┌──────────────────────┐
│struct REGPACK │
│{ │
│ unsigned r_ax,r_bx,r_cx,r_dx; │
│ unsigned r_bp,r_si,r_di,r_ds,r_es,r_flags; │
│} │
└──────────────────────┘
函数执行完后,将新的寄存器值存于结构preg中
void keep(int status,int size)
以status状态返回MSDOS,但程序仍保留于内存中,所占用空间由size决定.
void ctrlbrk(int (*fptr)()) 设置中断后的对中断的处理程序.
void disable() 禁止发生中断
void enable() 允许发生中断
void geninterrupt(int intr_num) 执行由intr_num所指定的软件中断
void interrupt(* getvect(int intr_num))()
返回中断号为intr_num的中断处理程序, 例如: old_int_10h=getvect(0×10);
void setvect(int intr_num,void interrupt(* isr)())
设置中断号为intr_num的中断处理程序为isr,例如: setvect(0×10,new_int_10h);
void harderr(int (*fptr)())
定义一个硬件错误处理程序, 每当出现错误时就调用fptr所指的程序
void hardresume(int rescode) 硬件错误处理函数
void hardretn(int errcode) 硬件错误处理函数
int inport(int prot) 从指定的输入端口读入一个字,并返回这个字
int inportb(int port) 从指定的输入端口读入一个字节,并返回这个字节
void outport(int port,int word) 将字word写入指定的输出端口port
void outportb(int port,char byte) 将字节byte写入指定的输出端口port
int peek(int segment,unsigned offset)
函数返回segment:offset处的一个字
char peekb(int segment,unsigned offset)
函数返回segment:offset处的一个字节
void poke(int segment,int offset,char value)
将字value写到segment:offset处
void pokeb(int segment,int offset,int value)
将字节value写到segment:offset处
int randbrd(struct fcb *fcbptr,int reccnt)
函数利用打开fcbptr所指的FCB读reccnt个记录.
int randbwr(struct fcb *fcbptr,int reccnt)
函数将fcbptr所指的FCB中的reccnt个记录写到磁盘上
void segread(struct SREGS *segtbl)函数把段寄存器的当前值放进结构segtbl中
int getverify() 取检验标志的当前状态(0=检验关闭,1=检验打开)
void setverify(int value)
设置当前检验状态, value为0表示关闭检验,为1表示打开检验
int getcbrk()本函数返回控制中断检测的当前设置
int setcbrk(int value)本函数用来设置控制中断检测为接通或断开当value=0时,为断开检测.当value=1时,为接开检测
int dosexterr(struct DOSERR *eblkp)
取扩展错误.在DOS出现错误后,此函数将扩充的错误信息填入eblkp所指的DOSERR结构中.该结构定义如下:
┌──────────────┐
│struct DOSERR │
│{ │
│ int exterror;/*扩展错误*/ │
│ char class; /*错误类型*/ │
│ char action; /*方式*/ │
│ char locus; /*错误场所*/ │
│} │
└──────────────┘
int bioscom(int cmd,char type,int port) 本函数负责对数据的通讯工作,
cmd可以为以下值:
0 置通讯参数为字节byte值 1 发送字符通过通讯线输出
2 从通讯线接受字符 3 返回通讯的当前状态
port为通讯端口,port=0时通讯端口为COM1,port=1时通讯端口为COM2,以此类推
byte为传送或接收数据时的参数,为以下位的组合:
┌───┬─────┬───┬─────┬───┬─────┐
│byte值│意义 │byte值│意义 │byte值│意义 │
├───┼─────┼───┼─────┼───┼─────┤
│0×02 │7数据位 │0×03 │8数据位 │0×00 │1停止位 │
│0×04 │2停止位 │0×00 │无奇偶性 │0×08 │奇数奇偶性│
│0×18 │偶数奇偶性│0×00 │110波特 │0×20 │150波特 │
│0×40 │300波特 │0×60 │600波特 │0×80 │1200波特 │
│0xA0 │2400波特 │0xC0 │4800波特 │0xE0 │9600波特 │
└───┴─────┴───┴─────┴───┴─────┘

例如:0xE0|0×08|0×00|0×03即表示置通讯口为9600波特,奇数奇偶性,1停止位,
8数据位. 函数返回值为一个16位整数,定义如下:
第15位 超时
第14位 传送移位寄存器空
第13位 传送固定寄存器空
第12位 中断检测
第11位 帧错误
第10位 奇偶错误
第 9位 过载运行错误
第 8位 数据就绪
第 7位 接收线信号检测
第 6位 环形指示器
第 5位 数据设置就绪
第 4位 清除发送
第 3位 δ接收线信号检测器
第 2位 下降边环形检测器
第 1位 δ数据设置就绪
第 0位 δ清除发送

int biosdisk(int cmd,int drive,int head,int track, int sector,int nsects,void *buffer)
本函数用来对驱动器作一定的操作,cmd为功能号, drive为驱动器号(0=A,1=B,0×80=C,0×81=D,0×82=E等).cmd可为以下值:

0 重置软磁盘系统.这强迫驱动器控制器来执行硬复位.忽略所有其它参数.
1 返回最后的硬盘操作状态.忽略所有其它参数
2 读一个或多个磁盘扇区到内存.读开始的扇区由head、track、sector给出。扇区号由nsects给出。把每个扇区512个字节的数据读入buffer
3 从内存读数据写到一个或多个扇区。写开始的扇区由head、track、sector给出。扇区号由nsects给出。所写数据在buffer中，每扇区512个字节。
4 检验一个或多个扇区。开始扇区由head、track、sector给出。扇区号由nsects给出。
5 格式化一个磁道，该磁道由head和track给出。buffer指向写在指定track上的扇区磁头器的一个表。以下cmd值只允许用于XT或AT微机：
6 格式化一个磁道，并置坏扇区标志。
7 格式化指定磁道上的驱动器开头。
8 返回当前驱动器参数，驱动器信息返回写在buffer中(以四个字节表示)。
9 初始化一对驱动器特性。
10 执行一个长的读，每个扇区读512加4个额外字节
11 执行一个长的写，每个扇区写512加4个额外字节
12 执行一个磁盘查找
13 交替磁盘复位
14 读扇区缓冲区
15 写扇区缓冲区
16 检查指定的驱动器是否就绪
17 复核驱动器
18 控制器RAM诊断
19 驱动器诊断
20 控制器内部诊

函数返回由下列位组合成的状态字节：
0×00 操作成功
0×01 坏的命令
0×02 地址标记找不到
0×04 记录找不到
0×05 重置失败
0×07 驱动参数活动失败
0×09 企图DMA经过64K界限
0x0B 检查坏的磁盘标记
0×10 坏的ECC在磁盘上读
0×11 ECC校正的数据错误（注意它不是错误）
0×20 控制器失效
0×40 查找失败
0×80 响应的连接失败
0xBB 出现无定义错误
0xFF 读出操作失败

int biodquip()
检查设备，函数返回一字节，该字节每一位表示一个信息，如下：
第15位 打印机号
第14位 打印机号
第13位 未使用
第12位 连接游戏I/O
第11位 RS232端口号
第 8位 未使用
第 7位 软磁盘号
第 6位 软磁盘号,
00为1号驱动器,01为2号驱动器,10为3号驱动器,11为4号驱动器

第 5位 初始化
第 4位 显示器模式
00为未使用，01为40x25BW彩色显示卡
10为80x25BW彩色显示卡，11为80x25BW单色显示卡
第 3位 母扦件
第 2位 随机存贮器容量,00为16K,01为32K,10为48K,11为64K
第 1位 浮点共用处理器
第 0位 从软磁盘引导

int bioskey(int cmd)本函数用来执行各种键盘操作，由cmd确定操作。
cmd可为以下值：
0 返回敲键盘上的下一个键。若低8位为非0,即为ASCII字符；若低8位为0,
则返回扩充了的键盘代码。
1 测试键盘是否可用于读。返回0表示没有键可用；否则返回下一次敲键之值。
敲键本身一直保持由下次调用具的cmd值为0的bioskey所返回的值。
2 返回当前的键盘状态，由返回整数的每一个位表示，见下表：
┌──┬───────────┬───────────┐
│ 位 │为0时意义 │为1时意义 │
├──┼───────────┼───────────┤
│ 7 │插入状态 │改写状态 │
│ 6 │大写状态 │小写状态 │
│ 5 │数字状态，NumLock灯亮 │光标状态，NumLock灯熄 │
│ 4 │ScrollLock灯亮 │ScrollLock灯熄 │
│ 3 │Alt按下 │Alt未按下 │
│ 2 │Ctrl按下 │Ctrl未按下 │
│ 1 │左Shift按下 │左Shift未按下 │
│ 0 │右Shift按下 │右Shift未按下 │
└──┴───────────┴───────────┘
int biosmemory() 返回内存大小,以K为单位.
int biosprint(int cmd,int byte,int port) 控制打印机的输入/输出.
port为打印机号,0为LPT1,1为LPT2,2为LPT3等
cmd可以为以下值:
0 打印字符,将字符byte送到打印机
1 打印机端口初始化
2 读打印机状态
函数返回值由以下位值组成表示当前打印机状态
0×01 设备时间超时
0×08 输入/输出错误
0×10 选择的
0×20 走纸
0×40 认可
0×80 不忙碌

int biostime(int cmd,long newtime)计时器控制,cmd为功能号,可为以下值

0 函数返回计时器的当前值
1 将计时器设为新值newtime

struct country *country(int countrycmode,struct country *countryp)
本函数用来控制某一国家的相关信息,如日期,时间,货币等.
若countryp=-1时,当前的国家置为countrycode值(必须为非0).否则,由countryp所指向的country结构用下列的国家相关信息填充:
(1)当前的国家(若countrycode为0或2)由countrycode所给定的国家.
结构country定义如下:
┌────────────────────┐
│struct country │
│{ │
│ int co_date; /*日期格式*/ │
│ char co_curr[5]; /*货币符号*/ │
│ char co_thsep[2]; /*数字分隔符*/ │
│ char co_desep[2]; /*小数点*/ │
│ char co_dtsep[2]; /*日期分隔符*/ │
│ char co_tmsep[2]; /*时间分隔符*/ │
│ char co_currstyle; /*货币形式*/ │
│ char co_digits; /*有效数字*/ │
│ int (far *co_case)(); /*事件处理函数*/ │
│ char co_dasep; /*数据分隔符*/ │
│ char co_fill[10]; /*补充字符*/ │
│} │
└────────────────────┘
co_date的值所代表的日期格式是:
0 月日年 1 日月年 2 年月日
co_currstrle的值所代表的货币显示方式是
0 货币符号在数值前,中间无空格
1 货币符号在数值后,中间无空格
2 货币符号在数值前,中间有空格
3 货币符号在数值后,中间有空格