此函式是否可用依裝置支援項目而定。
將數據寫入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 |
參見