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

参见

KsReadFile