mmioSetBuffer 函式 (mmiscapi.h)
mmioSetBuffer函式會啟用或停用緩衝 I/O,或使用mmioOpen函式變更開啟之檔案的緩衝區或緩衝區大小。
語法
MMRESULT mmioSetBuffer(
HMMIO hmmio,
LPSTR pchBuffer,
LONG cchBuffer,
UINT fuBuffer
);
參數
hmmio
檔案的檔案控制碼。
pchBuffer
要用於緩衝 I/O 之應用程式定義緩衝區的指標。 如果此參數為 Null, mmioSetBuffer 會為緩衝 I/O 配置內部緩衝區。
cchBuffer
大小、以字元為單位、應用程式定義的緩衝區,或 要配置之 mmioSetBuffer 的緩衝區大小。
fuBuffer
保留;必須是零。
傳回值
如果成功或發生錯誤,則傳回零。 如果發生錯誤,檔案控制碼仍有效。 定義下列值。
傳回碼 | 描述 |
---|---|
|
舊緩衝區的內容無法寫入磁片,因此作業已中止。 |
|
無法配置新的緩衝區,可能是因為記憶體不足。 |
備註
若要使用內部緩衝區啟用緩衝處理,請將 pchBuffer 設定為 Null , 並將 cchBuffer 設定為所需的緩衝區大小。
若要提供您自己的緩衝區,請將 pchBuffer 設定為指向緩衝區,並將 cchBuffer 設定為緩衝區的大小。
若要停用緩衝的 I/O,請將 pchBuffer 設定為 Null , 並將 cchBuffer 設定為零。
如果緩衝 I/O 已經使用內部緩衝區啟用,您可以將 pchBuffer 設定為 Null , 並將 cchBuffer 重新配置為不同的大小,並將 cchBuffer 設定為新的緩衝區大小。 調整大小之後,可以變更緩衝區的內容。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mmiscapi.h (包含 mmiscapi.h、Windows.h) |
程式庫 | Winmm.lib |
Dll | Winmm.dll |