<Return[A]><Top>

acmFilterChoose

Declare Function Api_acmFilterChoose& Lib "msacm32" Alias "acmFilterChooseA" (ByRef pafltrc As ACMFILTERCHOOSEA)

Declare Function acmFilterChoose Lib "msacm32" Alias "acmFilterChooseA" (ByRef pafltrc As ACMFILTERCHOOSEA) As Long

ACM 定義のダイアログボックスを作成し、ユーザーがウェーブフォームオーディオフィルタを選択できるようにする。

パラメータ

pafltrc
    ダイアログボックスの初期化に使う情報を受け取る 構造体のアドレスを指定する。acmFilterChoose 関数に制御が返ると、この構造体には

    ユーザーのフィルタ選択に関する情報が格納される。
    この構造体の pwfltr メンバには、フィルタヘッダ構造が入るバッファへのポインタを指定しなければならない。さらに、cbwfltr メンバには、こ

    のメモリバッファのサイズをバイト単位で指定しなければならない。

戻り値
    関数が成功すると MMSYSERR_NOERROR を、失敗するとエラーが返る。返されるエラー値は次のとおりである。

    値                                                

説明                                                                                                                              

    ACMERR_CANCELED

 

ACMFILTERCHOOSE 構造体の pwfltr メンバで指定されたバッファは、選択されたフィルタを入れるには小さすぎる。

    MMSYSERR_INVALFLAG

少なくとも 1 つのフラグが無効である。

    MMSYSERR_INVALHANDLE

指定されたハンドルは無効である。

    MMSYSERR_INVALPARAM 少なくとも 1 つのパラメータが無効である。
    MMSYSERR_NODRIVER 適切なドライバが利用できないため、有効なフィルタを選択できない。