acmStreamSize 函式 (msacm.h)

acmStreamSize 函式會傳回 ACM 數據流上來源或目的地緩衝區的建議大小。

語法

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

has

轉換數據流的句柄。

cbInput

來源或目的地緩衝區的大小，以位元組為單位。 fdwSize 旗標會指定輸入參數所定義的內容。此參數必須是非零。

pdwOutputBytes

包含來源或目的地緩衝區大小之變數的指標，以位元組為單位。 fdwSize 旗標會指定輸出參數所定義的內容。如果 acmStreamSize 函式成功，此位置一律會填入非零值。

fdwSize

數據流大小查詢的旗標。已定義下列值：

值	意義
ACM_STREAMSIZEF_DESTINATION	cbInput 參數包含目的地緩衝區的大小。 pdwOutputBytes 參數會收到建議的來源緩衝區大小，以位元組為單位。
ACM_STREAMSIZEF_SOURCE	cbInput 參數包含來源緩衝區的大小。 pdwOutputBytes 參數將會收到建議的目的地緩衝區大小，以位元組為單位。

如果成功或發生錯誤，則傳回零。可能的錯誤值包括下列專案。

應用程式可以使用此函式來判斷來源或目的地緩衝區的建議緩衝區大小。傳回的緩衝區大小可能只是轉換所需的實際大小估計。因為無法一律判斷實際轉換大小而不執行轉換，所以傳回的大小通常會過度擷取。

如果發生錯誤， pdwOutputBytes 所指向的位置將會收到零。這假設 pdwOutputBytes 指定的指標有效。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	msacm.h
程式庫	Msacm32.lib
Dll	Msacm32.dll