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 參數將會收到建議的目的地緩衝區大小，以位元組為單位。 |
傳回值
如果成功或發生錯誤，則傳回零。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
無法執行要求的作業。 |
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
備註
應用程式可以使用此函式來判斷來源或目的地緩衝區的建議緩衝區大小。 傳回的緩衝區大小可能只是轉換所需的實際大小估計。 因為無法一律判斷實際轉換大小而不執行轉換，所以傳回的大小通常會過度擷取。
如果發生錯誤， pdwOutputBytes 所指向的位置將會收到零。 這假設 pdwOutputBytes 指定的指標有效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | msacm.h |
| 程式庫 | Msacm32.lib |
| Dll | Msacm32.dll |