共用方式為

mmioGetInfo 函式 (mmiscapi.h)

  • 發行項

mmioGetInfo函式會擷取使用mmioOpen函式開啟之檔案的相關資訊。 如果檔案已針對緩衝 I/O 開啟，這項資訊可讓應用程式直接存取 I/O 緩衝區。

語法

MMRESULT mmioGetInfo(
  HMMIO      hmmio,
  LPMMIOINFO pmmioinfo,
  UINT       fuInfo
);

參數

hmmio

檔案的檔案控制碼。

pmmioinfo

緩衝區的指標，該緩衝區會接收mmioGetInfo填入檔案相關資訊的MMIOINFO結構。

fuInfo

保留;必須是零。

傳回值

如果成功或發生錯誤，則傳回零。

備註

若要直接存取針對緩衝 I/O 開啟之檔案的 I/O 緩衝區，請使用mmioGetInfo 所填入之 MMIOINFO結構的下列成員：

  • pchNext成員會指向緩衝區中可讀取或寫入的下一個位元組。 當您讀取或寫入時，會以讀取或寫入的位元組數目遞增 pchNext 。
  • pchEndRead成員指向緩衝區中最後一個有效位元組之後的 1 個位元組，該位元組可以讀取。
  • pchEndWrite成員指向緩衝區中最後一個可寫入位置的 1 位元組。
讀取或寫入緩衝區並修改 pchNext之後，請勿呼叫 mmioAdvance 以外的任何多媒體檔案 I/O 函式，直到您呼叫 mmioSetInfo 函 式為止。 當您完成直接存取緩衝區時，請呼叫 mmioSetInfo 。

當您到達 pchEndRead 或 pchEndWrite 成員所指定的緩衝區結尾時，請呼叫 mmioAdvance 以從磁片填滿緩衝區，或將緩衝區寫入磁片。 mmioAdvance函式會更新檔案 MMIOINFO結構中的pchNext、pchEndRead和pchEndWrite成員。

呼叫mmioAdvance或mmioSetInfo以將緩衝區排清到磁片之前，請先在檔案 MMIOINFO結構的dwFlags成員中設定MMIO_DIRTY旗標。 否則，緩衝區將不會寫入磁片。

請勿遞減pchNext 或修改pchNext和dwFlags以外的MMIOINFO結構中的任何成員。 除了MMIO_DIRTY以外，請勿在 dwFlags 中設定任何旗標。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mmiscapi.h (包含 mmiscapi.h、Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll