acmFilterChoose 関数 (msacm.h)
acmFilterChoose 関数は、ユーザーが波形オーディオ フィルターを選択できるようにする ACM 定義のダイアログ ボックスを作成します。
構文
MMRESULT ACMAPI acmFilterChoose(
LPACMFILTERCHOOSE pafltrc
);
パラメーター
pafltrc
ダイアログ ボックスの初期化に使用される情報を含む ACMFILTERCHOOSE 構造体へのポインター。 acmFilterChoose が返されると、この構造体にはユーザーのフィルター選択に関する情報が含まれます。
この構造体の pwfltr メンバーには、返されるフィルター ヘッダー構造体を格納するメモリ位置への有効なポインターが含まれている必要があります。 cbwfltr メンバーは、このメモリ バッファーのサイズ (バイト単位) で入力する必要があります。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
ユーザーは、[システム] メニューの [キャンセル] ボタンまたは [閉じる] コマンドを選択してダイアログ ボックスを閉じます。 |
|
[ACMFILTERCHOOSE]() 構造体によって識別されるバッファーが小さすぎて、選択したフィルターを含められません。 |
|
少なくとも 1 つのフラグが無効です。 |
|
指定されたハンドルが無効です。 |
|
少なくとも 1 つのパラメーターが無効です。 |
|
適切なドライバーは、有効なフィルター選択を提供するために使用できません。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msacm.h |
| Library | Msacm32.lib |
| [DLL] | Msacm32.dll |