KsWriteFile
此函式是否可用依装置支援项目而定。
将数据写入COM 埠。
语法
BOOL KsWriteFile(
HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped
);
参数
hFile:欲写入的连接埠。
lpBuffer:包含欲写入档案之资料的缓冲区指标。
nNumberOfBytesToWrite:欲写入档案的位元组数量。Windows 将零值解释为指定空位元写入作业, 其不写入任何位元组但会造成时间戳记的更改。
lpNumberOfBytesWritten:此函式写入的位元组数量指标。KsWriteFile 在未执行任何动作或检查错误时将此值设为零,若 lpOverlapped 为 NULL , 则lpNumberOfBytesWritten 不可为 NULL。
lpOverlapped(RTSS 不支援):此参数必须设置为 NULL。
回传值
若函式执行成功将回传 TRUE;失败将回传 FALSE。欲获取延伸错误资讯请呼叫 GetLastError。
备注
RTX64 不支援异步作业。
若档案的一部分被另一个处理序锁定且写入作业与锁定部分重叠,则此函式将执行失败。
在写入作业完成之前,应用程式不得读取或写入读取作业正在使用的输出缓冲区,过早存取输出缓冲区可能会导致读入该缓冲区的资料毁损。
Windows 将欲写入的零位元组解释为指定空位元写入操作,而 KsWriteFile 不会截断或扩展档案。
范例
N/A
使用需求
RT | Win32 | |
---|---|---|
最低支援版本 | 4.0 | 4.0 |
标头档 | kscom.h | kscom.h |
程式库 | KsApi_Rtss.lib | ksapi.h |
参见