次の方法で共有

acmFilterDetailsA 関数 (msacm.h)

  • [アーティクル]

acmFilterDetails 関数は、特定の波形オーディオ フィルター タグを持つフィルターに関する詳細を ACM に照会します。

構文

MMRESULT ACMAPI acmFilterDetailsA(
  HACMDRIVER          had,
  LPACMFILTERDETAILSA pafd,
  DWORD               fdwDetails
);

パラメーター

had

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

pafd

指定されたフィルター タグのフィルターの詳細を受け取る ACMFILTERDETAILS 構造体へのポインター。

fdwDetails

詳細を取得するためのフラグ。 次の値が定義されています。

[ACMFILTERDETAILS](./nf-msacm-acmfilterdetails.md) 構造体が指定され、残りの詳細が返されます。 ACMFILTERDETAILS 構造体の dwFilterTag メンバーは、pwfltr 指定 同じフィルター タグに初期化する必要があります。 このクエリの種類を使用して、任意のフィルター構造の文字列の説明を取得できます。 した の ACM ドライバー ハンドルをアプリケーションで指定した場合、そのドライバーのフィルターの詳細が返されます。 がNULL をアプリケーションが指定した場合、ACM は、詳細を返す最初の許容されるドライバーを検索します。
価値 意味
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX フィルター タグのフィルター インデックスは、ACMFILTERDETAILS 構造体の dwFilterIndex メンバーで指定されました。 フィルターの詳細は、pafdによって定義された構造で返されます。 インデックスの範囲は、フィルター タグの ACMFILTERTAGDETAILS 構造体で返される cStandardFilters メンバーより 0 から 1 未満です。 アプリケーションは、このフラグを使用してフィルターの詳細を取得するときに のドライバー ハンドルを指定する必要があります。 この関数を呼び出す前に初期化する必要があるメンバーの詳細については、ACMFILTERDETAILS 構造体を参照してください。

戻り値

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

リターン コード 形容
ACMERR_NOTPOSSIBLE
 要求された詳細は使用できません。
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALHANDLE
 指定されたハンドルが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。

備考

手記

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

必要条件

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

関連項目

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

Audio Compression Manager