acmFilterChoose 函式 (msacm.h)

acmFilterChoose 函式會建立 ACM 定義的對話框，讓用戶能夠選取電壓音訊篩選器。

語法

MMRESULT ACMAPI acmFilterChoose(
  LPACMFILTERCHOOSE pafltrc
);

pafltrc

ACMFILTERCHOOSE 結構的指標，其中包含用來初始化對話框的資訊。 當 acmFilterChoose 傳回時，此結構會包含使用者篩選選取專案的相關信息。

這個結構的 pwfltr 成員必須包含記憶體位置的有效指標，該指標將包含傳回的篩選標頭結構。 cbwfltr 成員必須填入此記憶體緩衝區的大小，以位元組為單位。

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

傳回碼	Description
ACMERR_CANCELED	使用者選擇 [系統] 選單上的 [取消] 按鈕或 [關閉] 命令來關閉對話框。
ACMERR_NOTPOSSIBLE	[ACMFILTERCHOOSE] 所識別的緩衝區 () 結構太小而無法包含選取的篩選條件。
MMSYSERR_INVALFLAG	至少有一個旗標無效。
MMSYSERR_INVALHANDLE	指定的句柄無效。
MMSYSERR_INVALPARAM	至少有一個參數無效。
MMSYSERR_NODRIVER	無法使用適當的驅動程式來提供有效的篩選選項。

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