ACM 資料流轉換的 ACMSTREAMHEADER 結構。 此函式必須先針對每個數據流標頭呼叫,才能在轉換數據流中使用。 應用程式只需要在指定的數據流存留期間準備數據流標頭一次。 只要來源和目的地緩衝區的大小未超過原本備妥數據流標頭時所使用的大小,就可以重複使用數據流標頭。
語法
MMRESULT ACMAPI acmStreamPrepareHeader(
HACMSTREAM has,
LPACMSTREAMHEADER pash,
DWORD fdwPrepare
);
參數
has
轉換數據流的句柄。
pash
ACMSTREAMHEADER 結構的指標,可識別要準備的來源和目的地緩衝區。
fdwPrepare
保留;必須是零。
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
|
系統無法配置資源。 |
備註
準備已經備妥的數據流標頭沒有任何作用,而且函式會傳回零。 不過,您應該確保應用程式不會多次準備數據流標頭。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | msacm.h |
| 程式庫 | Msacm32.lib |
| Dll | Msacm32.dll |