ACMFILTERDETAILS 構造体 (msacm.h)
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 | 説明 |
|---|---|
|
ドライバーでは、非同期変換がサポートされています。 |
|
ドライバーは、指定されたフィルターを使用しながら、2 つの異なる書式タグ間の変換をサポートしています。 たとえば、ドライバーが指定したフィルターを使用してWAVE_FORMAT_PCMからWAVE_FORMAT_ADPCMへの圧縮をサポートしている場合、このフラグが設定されます。 |
|
ドライバーは、指定されたフィルターを使用しながら、同じ書式タグの 2 つの異なる形式間の変換をサポートしています。 たとえば、ドライバーが指定したフィルターを使用してWAVE_FORMAT_PCMの再サンプリングをサポートしている場合、このフラグが設定されます。 |
|
ドライバーはフィルターをサポートしています (形式属性を変更せずにデータを変更します)。 たとえば、ドライバーがWAVE_FORMAT_PCMでボリューム操作またはエコー操作をサポートしている場合、このフラグが設定されます。 |
|
ドライバーは、波形オーディオ デバイスを介して指定されたフィルターを使用して、ハードウェア入力、出力、またはその両方をサポートします。 アプリケーションでは、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 |