acmFormatTagEnum

Declare Function Api_acmFormatTagEnum& Lib "msacm32" Alias "acmFormatTagEnumA" (ByVal had&, ByRef paftd As ACMFORMATTAGDETAILSA, ByVal fnCallback&, ByRef dwInstance&, ByVal fdwEnum&)

Declare Function acmFormatTagEnum Lib "msacm32" Alias "acmFormatTagEnumA" (ByVal had As Long, ByRef paftd As ACMFORMATTAGDETAILSA, ByVal fnCallback As Long, ByRef dwInstance As Long, ByVal fdwEnum As Long) As Long

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

パラメータ

had

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

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

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

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

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

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

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

    れない。