acmFilterEnum 関数 (msacm.h)

  • [アーティクル]

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

構文

MMRESULT ACMAPI acmFilterEnum(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  ACMFILTERENUMCB    fnCallback,
  DWORD_PTR          dwInstance,
  DWORD              fdwEnum
);

パラメーター

had

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

pafd

fnCallback によって指定された関数に渡されるときにフィルターの詳細を含む ACMFILTERDETAILS 構造体へのポインター。 アプリケーションが acmFilterEnum を呼び出すときは、この構造体の cbStruct、 pwfltr、 および cbwfltr メンバーを初期化する必要があります。 dwFilterTag メンバーは、WAVE_FILTER_UNKNOWNまたは有効なフィルター タグに初期化する必要もあります。

fnCallback

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

dwInstance

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

fdwEnum

特定のフィルター タグのフィルターを列挙するためのフラグ。 次の値が定義されています。

[ACMFILTERDETAILS](./nf-msacm-acmfilterdetails.md) 構造体が有効です。 列挙子は、この属性に準拠するフィルターのみを列挙します。 ACMFILTERDETAILS 構造体の dwFilterTag メンバーは、WAVEFILTER 構造体の dwFilterTag メンバーと等しい必要があります。
値 意味
ACM_FILTERENUMF_DWFILTERTAG

戻り値

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

リターン コード 説明
ACMERR_NOTPOSSIBLE
 フィルターの詳細を返すことができません。
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALHANDLE
 指定されたハンドルが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。

注釈

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

コールバック関数内から acmDriverAdd、acmDriverRemove、および acmDriverPriority の各関数を呼び出さないでください。

要件

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

こちらもご覧ください

オーディオ圧縮関数

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