acmFilterTagEnumW 関数 (msacm.h)

  • [アーティクル]

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

構文

MMRESULT ACMAPI acmFilterTagEnumW(
  HACMDRIVER             had,
  LPACMFILTERTAGDETAILSW paftd,
  ACMFILTERTAGENUMCBW    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

パラメーター

had

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

paftd

fnCallback 関数に渡されたときのフィルター タグの詳細を含む ACMFILTERTAGDETAILS 構造体へのポインター。 アプリケーションで acmFilterTagEnum を呼び出すときは、この構造体の 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 バージョンを自動的に選択するエイリアスとして acmFilterTagEnum を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

オーディオ圧縮関数

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