ACMFILTERTAGENUMCBW コールバック関数 (msacm.h)

  • [アーティクル]

acmFilterTagEnumCallback 関数は、acmFilterTagEnum 関数で使用されるコールバック関数を指定します。 acmFilterTagEnumCallback 関数名は、アプリケーション定義関数名のプレースホルダーです。

構文

ACMFILTERTAGENUMCBW Acmfiltertagenumcbw;

BOOL Acmfiltertagenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

パラメーター

hadid

ACM ドライバー識別子を処理します。

paftd

列挙フィルター タグの詳細を含む ACMFILTERTAGDETAILS 構造体へのポインター。

dwInstance

acmFilterTagEnum で指定されたアプリケーション定義値。

fdwSupport

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

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

戻り値

コールバック関数は、列挙を続行するには TRUE を 返し、列挙を停止するには FALSE を 返す必要があります。

解説

フィルター タグを列挙しない場合、 acmFilterTagEnum 関数は MMSYSERR_NOERROR (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。

コールバック関数内から acmDriverAdd、acmDriverRemove、および acmDriverPriority の各関数を呼び出さないでください。

Note

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

要件

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

関連項目

オーディオ圧縮関数

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