次の方法で共有

acmFilterEnumW 関数 (msacm.h)

  • [アーティクル]

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

構文

MMRESULT ACMAPI acmFilterEnumW(
  HACMDRIVER          had,
  LPACMFILTERDETAILSW pafd,
  ACMFILTERENUMCBW    fnCallback,
  DWORD_PTR           dwInstance,
  DWORD               fdwEnum
);

パラメーター

had

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

pafd

fnCallbackで指定された関数にフィルターの詳細を渡すときにフィルターの詳細を含む ACMFILTERDETAIL S 構造体へのポインター。 アプリケーションが 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 つのパラメーターが無効です。

備考

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

コールバック関数内から、acmDriverAdd、acmDriverRemove、acmDriverPriorityを する必要があります。

手記

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

必要条件

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

関連項目

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

Audio Compression Manager