ACMFILTERTAGDETAILS 構造体 (msacm.h)

  • [アーティクル]

ACMFILTERTAGDETAILS 構造体は、ACM フィルター ドライバーの波形オーディオ フィルター タグの詳細を示します。

構文

typedef struct tACMFILTERTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFilterTagIndex;
  DWORD dwFilterTag;
  DWORD cbFilterSize;
  DWORD fdwSupport;
  DWORD cStandardFilters;
  char  szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
} ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, *LPACMFILTERTAGDETAILS;

メンバー

cbStruct

ACMFILTERTAGDETAILS 構造体のサイズ (バイト単位)。 このメンバーは、アプリケーションが acmFilterTagDetails または acmFilterTagEnum 関数を 呼び出す前に初期化する必要があります。 このメンバーで指定するサイズは、基本 ACMFILTERTAGDETAILS 構造体を含むのに十分な大きさである必要があります。 acmFilterTagDetails 関数が返されると、このメンバーには、返される情報の実際のサイズが含まれます。 返される情報は、要求されたサイズを超えることはありません。

dwFilterTagIndex

詳細を取得するフィルター タグのインデックス。 インデックスの範囲は、ACM ドライバーでサポートされているフィルター タグの数よりも 0 から 1 未満です。 ドライバーでサポートされているフィルター タグの数は、 ACMDRIVERDETAILS 構造体に含まれています。 dwFilterTagIndex メンバーは、ドライバーに関するフィルター タグの詳細をインデックスで照会する場合にのみ使用されます。それ以外の場合、このメンバーは 0 である必要があります。

dwFilterTag

ACMFILTERTAGDETAILS 構造体が記述する波形オーディオ フィルター タグ。 このメンバーは、ACM_FILTERTAGDETAILSF_FILTERTAGおよびACM_FILTERTAGDETAILSF_LARGESTSIZEクエリ フラグの入力として使用されます。 acmFilterTagDetails 関数が成功した場合、このメンバーは常に返されます。 このメンバーは、他のすべてのクエリ フラグに対してWAVE_FILTER_UNKNOWNに設定する必要があります。

cbFilterSize

dwFilterTag 型の波形オーディオ フィルターの最大合計サイズ (バイト単位)。 たとえば、このメンバーは、WAVE_FILTER_ECHOの場合は 40、WAVE_FILTER_VOLUMEの場合は 36 になります。

fdwSupport

フィルター タグに固有のドライバーサポート フラグ。 これらのフラグは 、ACMDRIVERDETAILS 構造体と同じです。 このメンバーは、次の値の組み合わせにすることができ、ドライバーがフィルター タグを使用してサポートする操作を識別します。

Name 説明
ACMDRIVERDETAILS_SUPPORTF_ASYNC
 ドライバーでは、非同期変換がサポートされています。
ACMDRIVERDETAILS_SUPPORTF_CODEC
 ドライバーは、指定されたフィルター タグを使用しながら、2 つの異なる書式タグ間の変換をサポートします。 たとえば、ドライバーが指定したフィルター タグを使用してWAVE_FORMAT_PCMからWAVE_FORMAT_ADPCMへの圧縮をサポートしている場合、このフラグが設定されます。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER
 ドライバーは、指定されたフィルター タグを使用しながら、同じ書式タグの 2 つの異なる形式間の変換をサポートしています。 たとえば、ドライバーで、指定したフィルター タグを使用したWAVE_FORMAT_PCMの再サンプリングがサポートされている場合、このフラグが設定されます。
ACMDRIVERDETAILS_SUPPORTF_FILTER
 ドライバーはフィルターをサポートしています (形式属性を変更せずにデータを変更します)。 たとえば、ドライバーがWAVE_FORMAT_PCMでボリューム操作またはエコー操作をサポートしている場合、このフラグが設定されます。
ACMDRIVERDETAILS_SUPPORTF_HARDWARE
 ドライバーは、波形オーディオ デバイスを介して指定されたフィルター タグを使用して、ハードウェア入力、出力、またはその両方をサポートします。 アプリケーションでは、ACM_METRIC_HARDWARE_WAVE_INPUTとACM_METRIC_HARDWARE_WAVE_OUTPUTメトリック インデックスで acmMetrics 関数を使用して、サポートする ACM ドライバーに関連付けられている波形オーディオ デバイス識別子を取得する必要があります。

cStandardFilters

dwFilterTag 型の標準フィルターの数 (つまり、すべてのフィルター特性の組み合わせ)。 この値では、ドライバーでサポートされているすべてのフィルターを指定することはできません。

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

dwFilterTag 型を表す文字列。 acmFilterTagDetails 関数が成功した場合、この文字列は常に返されます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header msacm.h

関連項目

ACMDRIVERDETAILS

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

オーディオ圧縮構造

acmFilterTagDetails

acmFilterTagEnum