acmFormatTagDetails

Declare Function Api_acmFormatTagDetails& Lib "msacm32" Alias "acmFormatTagDetailsA" (ByVal had&, ByRef paftd As ACMFORMATTAGDETAILSA, ByVal fdwDetails&)

Declare Function acmFormatTagDetails Lib "msacm32" Alias "acmFormatTagDetailsA" (ByVal had As Long, ByRef paftd As ACMFORMATTAGDETAILSA, ByVal fdwDetails As Long) As Long

特定のウェーブフォームオーディオフォーマットタグの詳細について ACM を照会する。

パラメータ

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

    ACM は適切な ACM ドライバのうち最初のドライバの詳細を使う。ACM_FORMATTAGDETAILSF_INDEX 照会タイプを使う場合、アプ

    リケーションは有効なハンドルまたはドライバ識別子を指定しなければならない。無効なドライバのドライバ識別子は指定できない。
paftd
    フォーマットタグの詳細を受け取る 構造体のアドレスを指定する。
fdwDetails
    詳細を受け取るためのフラグを設定する。次の値が定義されている。
    ACM_FORMATTAGDETAILSF_FORMATTAG
        フォーマットタグは、 構造体の dwFormatTag メンバで与えられた。フォーマットタグの詳細は、paftd パラメータで指定する構造体が受

        け取る。had パラメータに ACM ドライバハンドルを指定すると、そのドライバのフォーマットタグの詳細が返る。had パラメータに NULL を

        指定すると、ACM は適切なドライバのうち最初に検索されたドライバの詳細を返す。
    ACM_FORMATTAGDETAILSF_INDEX
        フォーマットタグインデックスは、ACMFORMATTAGDETAILS 構造体の dwFormatTagIndex メンバで与えられた。フォーマットタグと詳

        細は、paftd パラメータで定義される構造体が受け取る。インデックスの範囲は 0〜ACM ドライバに対応する 構造体が受け取る

        cFormatTags メンバ -1 です。このフラグを設定してフォーマットタグの詳細を取得するときは、had パラメータにドライバハンドルを指定しな

        ければならない。
    ACM_FORMATTAGDETAILSF_LARGESTSIZE
        最もバイト数の大きいフォーマットタグに関する詳細が返される。最大サイズのフォーマットタグを検索するには、 構造体の

        dwFormatTag メンバが、WAVE_FORMAT_UNKNOWN またはフォーマットタグのいずれかでなければならない。had パラメータに

        ACM ドライバハンドルを指定すると、そのドライバに対応する、最大フォーマットタグの詳細が返される。アプリケーションが had パラメータ

        に NULL を指定すると、ACM は、要求された最大フォーマットタグを持つ適切なドライバを検索して詳細を返す。

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

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