acmFilterChoose 函式會建立 ACM 定義的對話框，讓用戶能夠選取電壓音訊篩選器。
語法
MMRESULT ACMAPI acmFilterChoose(
LPACMFILTERCHOOSE pafltrc
);
參數
pafltrc
ACMFILTERCHOOSE 結構的指標，其中包含用來初始化對話框的資訊。 當 acmFilterChoose 傳回時，此結構會包含使用者篩選選取專案的相關信息。
這個結構的 pwfltr 成員必須包含記憶體位置的有效指標，該指標將包含傳回的篩選標頭結構。 cbwfltr 成員必須填入此記憶體緩衝區的大小，以位元組為單位。
傳回值
如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
使用者選擇 [系統] 選單上的 [取消] 按鈕或 [關閉] 命令來關閉對話框。 |
|
[ACMFILTERCHOOSE] 所識別的緩衝區 () 結構太小而無法包含選取的篩選條件。 |
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
|
無法使用適當的驅動程式來提供有效的篩選選項。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | msacm.h |
| 程式庫 | Msacm32.lib |
| Dll | Msacm32.dll |