次の方法で共有


acmFormatTagEnumW 関数 (msacm.h)

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

構文

MMRESULT ACMAPI acmFormatTagEnumW(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSW paftd,
  ACMFORMATTAGENUMCBW    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 (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。

手記

msacm.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして acmFormatTagEnum を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msacm.h
ライブラリ Msacm32.lib
DLL Msacm32.dll

関連項目

オーディオ圧縮機能 を する

Audio Compression Manager