acmFilterTagDetails

Declare Function Api_acmFilterTagDetails& Lib "msacm32" Alias "acmFilterTagDetailsA" (ByVal had&, ByRef paftd As ACMFILTERTAGDETAILSA, ByVal fdwDetails&)

Declare Function acmFilterTagDetails Lib "msacm32" Alias "acmFilterTagDetailsA" (ByVal had As Long, ByRef paftd As ACMFILTERTAGDETAILSA, ByVal fdwDetails As Long) As Long

特定のウェーブフォームオーディオフィルタタグに関する ACM ドライバの詳細を照会する。

パラメータ

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

    は適切な ACM ドライバのうち最初のドライバの詳細を使う。アプリケーションは、ACM_FILTERTAGDETAILSF_INDEX 照会タイプを使う

    ときは、有効な HACMDRIVER 識別子または HACMDRIVERID 識別子を指定しなければならない。無効なドライバのドライバ識別子は

    許可されない。
paftd
    フィルタタグの詳細を受け取るための 構造体のアドレスを指定する。
fdwDetails
    フィルタタグの詳細を受け取るためのフラグを設定する。次の値が定義されている。
    ACM_FILTERTAGDETAILSF_FILTERTAG
        フィルタタグが、 構造体の dwFilterTag メンバで与えられた。フィルタタグの詳細は、paftd パラメータで指定した構造体が受け取る。

        アプリケーションが had パラメータに ACM ドライバハンドルを指定する場合、そのドライバのフィルタタグの詳細が返される。had パラメータ

        に NULL を指定する場合は、ACM は適切なドライバのうち最初に検索されたドライバの詳細を返す。
    ACM_FILTERTAGDETAILSF_INDEX
        フィルタタグインデックスが、 構造体の dwFilterTagIndex メンバで与えられた。フィルタタグと詳細は、paftd パラメータで指定した構造

        体が受け取る。インデックスの範囲は、0〜ACM ドライバに対応する ACMDRIVERDETAILS 構造体で返される cFilterTags メンバ -1

        である。このフラグを設定してフィルタタグの詳細を取得するには、had パラメータにドライバハンドルを指定しなければならない。
    ACM_FILTERTAGDETAILSF_LARGESTSIZE
        フィルタのバイト数が最も大きいフィルタタグに関する詳細が返される。最もサイズの大きいフィルタタグを検出するには、dwFilterTag メン

        バが WAVE_FILTER_UNKNOWN またはフィルタタグのいずれかでなければならない。had パラメータにドライバハンドルを指定する場

        合、そのドライバの最大のフィルタタグに関する詳細が返される。had パラメータに NULL を指定する場合は、ACM は、要求された最

        大のフィルタタグを持つ、適切なドライバを探して詳細を返す。

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

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