acmFilterTagEnum

Declare Function Api_acmFilterTagEnum& Lib "msacm32" Alias "acmFilterTagEnumA" (ByVal had&, ByRef paftd As ACMFILTERTAGDETAILSA, ByVal fnCallback&, ByRef dwInstance&, ByVal fdwEnum&)

Declare Function acmFilterTagEnum Lib "msacm32" Alias "acmFilterTagEnumA" (ByVal had As Long, ByRef paftd As ACMFILTERTAGDETAILSA, ByVal fnCallback As Long, ByRef dwInstance As Long, ByVal fdwEnum As Long) As Long

ACM ドライバから利用可能なウェーブオーディオフィルタタグを列挙する。この関数は、適切なフィルタタグがすべて列挙されるか、コールバック関数が FALSE を返すまで列挙を続ける。

パラメータ

had
    ウェーブフォームオーディオフィルタタグの詳細を照会する ACM ドライバのハンドルを指定する。このパラメータに NULL を指定すると、ACM

    は適切な ACM ドライバのうち最初のドライバの詳細を使う。
paftd
    fnCallback パラメータで指定するコールバック関数にフィルタタグの詳細が渡されるときに、それを受け取る 構造体のアドレスを指定する。

    acmFilterTagEnum 関数を呼び出すときは、この構造体の cbStruct メンバを初期化しなければならない。
fnCallback
    アプリケーション定義コールバック関数のプロシージャインスタンスアドレスを指定する。

dwInstance
    ACM フィルタタグの詳細とともにコールバック関数に渡される、32 ビットのアプリケーション定義値を指定する。

fdwEnum

    予約されている。0 を指定する。

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

値	説明
MMSYSERR_INVALFLAG	少なくとも 1 つのフラグが無効である。
MMSYSERR_INVALHANDLE	指定されたハンドルは無効である。
MMSYSERR_INVALPARAM	少なくとも 1 つのパラメータが無効である。

解説
    適切な ACM ドライバがインストールされていない場合、この関数は MMSYSERR_NOERROR(0)を返す。また、コールバック関数は呼び出

    されない。