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 位元組。

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

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

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

需求