次の方法で共有

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

  • [アーティクル]

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

構文

ACMFORMATENUMCBW Acmformatenumcbw;

BOOL Acmformatenumcbw(
  HACMDRIVERID hadid,
  LPACMFORMATDETAILSW pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

パラメーター

hadid

ACM ドライバー識別子へのハンドル。

pafd

書式タグの列挙形式の詳細を含む ACMFORMATDETAILS 構造体へのポインター。

dwInstance

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

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 ドライバーは、波形オーディオ デバイスを介して指定されたフォーマット タグのハードウェア入力、出力、または両方をサポートします。 アプリケーションでは、acmMetrics 関数をACM_METRIC_HARDWARE_WAVE_INPUTとACM_METRIC_HARDWARE_WAVE_OUTPUTメトリック インデックスと共に使用して、サポートする ACM ドライバーに関連付けられている波形オーディオ デバイス識別子を取得する必要があります。

戻り値

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

備考

acmFormatEnum 関数は、列挙する形式がない場合、MMSYSERR_NOERROR (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。

コールバック関数内から、acmDriverAdd、acmDriverRemove、acmDriverPriorityを する必要があります。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msacm.h

関連項目

オーディオ圧縮機能 を する

Audio Compression Manager