ACMFILTERDETAILS 構造体 (msacm.h)

[アーティクル]
08/24/2023

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

構文

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

メンバー

cbStruct

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

dwFilterIndex

詳細を取得するフィルターのインデックス。インデックスの範囲は、フィルタータグの ACM ドライバーでサポートされている標準フィルターの数より 0 から 1 未満です。フィルタータグのドライバーでサポートされている標準フィルターの数は、 ACMFILTERTAGDETAILS 構造体に含まれています。 dwFilterIndex メンバーは、ドライバーに関する標準フィルターの詳細をインデックスで照会する場合にのみ使用されます。それ以外の場合、このメンバーは 0 である必要があります。また、アプリケーションがフィルターの詳細を照会すると、このメンバーは ACM によってゼロに設定されます。つまり、このメンバーは入力にのみ使用され、ACM または ACM ドライバーによって返されることはありません。

dwFilterTag

ACMFILTERDETAILS 構造体が記述する波形オーディオフィルタータグ。このメンバーは、ACM_FILTERDETAILSF_INDEX クエリフラグの入力として使用されます。 ACM_FILTERDETAILSF_FORMAT クエリフラグの場合、このメンバーは pwfltr メンバーが指定したのと同じフィルタータグに初期化する必要があります。 acmFilterDetails 関数が成功した場合、このメンバーは常に返されます。このメンバーは、他のすべてのクエリフラグに対してWAVE_FILTER_UNKNOWNに設定する必要があります。

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 ドライバーに関連付けられている波形オーディオデバイス識別子を取得する必要があります。

pwfltr

フィルターの詳細を受け取る WAVEFILTER 構造体へのポインター。この構造体は、ACM_FILTERDETAILSF_FILTER フラグが acmFilterDetails 関数で指定されていない限り、アプリケーションによる初期化を必要としません。この場合、WAVEFILTER 構造体の dwFilterTag メンバーは、ACMFILTERDETAILS 構造体の dwFilterTag メンバーと等しい必要があります。

cbwfltr

pwfltr がフィルターの詳細を受け取るために使用できるサイズ (バイト単位)。 acmMetrics 関数と acmFilterTagDetails 関数を使用して、指定したドライバー (またはインストールされているすべての ACM ドライバー) で使用できるフィルターに必要な最大サイズを決定できます。

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

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

要件


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

Share via

ACMFILTERDETAILS 構造体 (msacm.h)

構文

メンバー

要件

関連項目

フィードバック

フィードバック

その他のリソース