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 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msacm.h
Library Msacm32.lib
[DLL] Msacm32.dll

こちらもご覧ください

オーディオ圧縮関数

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