共用方式為

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

保留;必須是零。

傳回值

如果成功或發生錯誤，則傳回零。 如果發生錯誤，檔案控制碼仍有效。 定義下列值。

傳回碼 描述
MMIOERR_CANNOTWRITE
 舊緩衝區的內容無法寫入磁片，因此作業已中止。
MMIOERR_OUTOFMEMORY
 無法配置新的緩衝區，可能是因為記憶體不足。

備註

若要使用內部緩衝區啟用緩衝處理，請將 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