KsReadFile

此函式是否可用依装置支援项目而定。

如可用，从 COM 埠读取资料。

语法

BOOL KsReadFile(
     HANDLE hFile,
     LPVOID lpBuffer,
     DWORD nNumberOfBytesToRead,
     LPDWORD lpNumberOfBytesRead,
     LPOVERLAPPED lpOverlapped
);

参数

Value：欲读取的连接埠。

lpBuffer：接收从档案读取之数据的缓冲区指标。

nNumberOfBytesToRead：欲从档案读取的位元组数量。

lpNumberOfBytesRead：读取的位元组数量的指标。KsReadFile 在未执行任何动作或检查错误时将此值设为零。

lpOverlapped（不支援）：此参数必须设置为 NULL。

回传值

若函式执行成功将回传 TRUE；失败将回传 FALSE。欲获取延伸错误资讯请呼叫 GetLastError。

注意：若回传值为 TRUE 且位元组数为零，则在读取作业时没有欲读取的资料。

备注

回传 KsReadFile 当请求的位元组数已被读取或发生错误。

若档案的一部分被另一个处理序锁定且读取作业与锁定部分重叠，则此函式将执行失败。

在读取作业完成之前，应用程式不得读取或写入读取作业正在使用的输入缓冲区，过早访问输入缓冲区可能会导致读入该缓冲区的资料毁损。

当同步读取作业到达档案最末端， KsReadFile 将回传 TRUE 并设定 *lpNumberOfBytesRead 为零。

范例

N/A

使用需求

	RT	Win32
最低支援版本	4.0	4.0
标头档	kscom.h	kscom.h
程式库	KsApi_Rtss.lib	ksapi.h

参见

KsWriteFile