Share via

acmFilterTagDetails 関数 (msacm.h)

  • [アーティクル]

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

構文

MMRESULT ACMAPI acmFilterTagDetails(
  HACMDRIVER            had,
  LPACMFILTERTAGDETAILS paftd,
  DWORD                 fdwDetails
);

パラメーター

had

ACM ドライバーにハンドルして、波形オーディオ フィルター タグの詳細を照会します。 このパラメーターが NULL の場合、ACM は最初の適切な ACM ドライバーの詳細を使用します。 ACM_FILTERTAGDETAILSF_INDEXクエリの種類を使用する場合、アプリケーションで有効な HACMDRIVER または HACMDRIVERID 識別子を指定する必要があります。 無効になっているドライバーのドライバー識別子は許可されません。

paftd

フィルター タグの詳細を受け取る ACMFILTERTAGDETAILS 構造体へのポインター。

fdwDetails

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

[ACMFILTERTAGDETAILS]() 構造体。 フィルター タグの詳細は、 paftd が指す構造体で返されます。 アプリケーションで had の ACM ドライバー ハンドルが指定されている場合は、そのドライバーのフィルター タグの詳細が返されます。 アプリケーションで had に NULL が指定されている場合、ACM は、詳細を返す最初の許容されるドライバーを見つけます。 [ACMDRIVERDETAILS](./nf-msacm-acmdriverdetails.md) ACM ドライバーの構造体。 アプリケーションでは、このフラグを使用してフィルター タグの詳細を取得するときに、 の ドライバー ハンドルを指定する必要があります。
値 意味
ACM_FILTERTAGDETAILSF_FILTERTAG
ACM_FILTERTAGDETAILSF_INDEX
ACM_FILTERTAGDETAILSF_LARGESTSIZE 最大のフィルター サイズを持つフィルター タグの詳細 (バイト単位) が返されます。 dwFilterTag メンバーは、最大サイズを検索するために、WAVE_FILTER_UNKNOWNまたはフィルター タグである必要があります。 アプリケーションで had の ACM ドライバー ハンドルが指定されている場合は、そのドライバーに対して最大のフィルター タグの詳細が返されます。 アプリケーションで had に NULL が指定されている場合、ACM は、詳細を返すように要求された最大のフィルター タグを持つ許容可能なドライバーを検索します。

戻り値

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

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

要件

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

こちらもご覧ください

オーディオ圧縮関数

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