acmFormatTagEnum 関数 (msacm.h)

  • [アーティクル]

acmFormatTagEnum 関数は、ACM ドライバーから使用可能な波形オーディオ形式タグを列挙します。 この関数は、適切な書式タグが存在しないか、コールバック関数が FALSE を返すまで列挙を続けます。

構文

MMRESULT ACMAPI acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    fnCallback,
  DWORD_PTR             dwInstance,
  DWORD                 fdwEnum
);

パラメーター

had

ACM ドライバーにハンドルして、波形オーディオ形式のタグの詳細を照会します。 このパラメーターが NULL の場合、ACM は最初の適切な ACM ドライバーの詳細を使用します。

paftd

fnCallback で指定された関数に渡される書式タグの詳細を受け取る ACMFORMATTAGDETAILS 構造体へのポインター。 この構造体には、ACMFORMATTAGDETAILS 構造体の cbStruct メンバーが初期化されている必要があります。

fnCallback

アプリケーション定義コールバック関数のプロシージャ インスタンス アドレス。

dwInstance

ACM 形式のタグの詳細と共にコールバック関数に渡される 64 ビット (DWORD_PTR) または 32 ビット (DWORD) アプリケーション定義値。

fdwEnum

予約;は 0 である必要があります。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

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

注釈

適切な ACM ドライバーがインストールされていない場合、この関数は MMSYSERR_NOERROR (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msacm.h
Library Msacm32.lib
[DLL] Msacm32.dll

こちらもご覧ください

オーディオ圧縮関数

オーディオ圧縮マネージャー