ACMFORMATENUMCBA コールバック関数 (msacm.h)
acmFormatEnumCallback 関数は、acmFormatEnum 関数で使用されるコールバック関数を指定します。 acmFormatEnumCallback 名は、アプリケーション定義関数名のプレースホルダーです。
構文
ACMFORMATENUMCBA Acmformatenumcba;
BOOL Acmformatenumcba(
HACMDRIVERID hadid,
LPACMFORMATDETAILSA 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 | ドライバーは、波形オーディオ デバイスを介して指定されたフォーマット タグのハードウェア入力、出力、または両方をサポートします。 アプリケーションでは、ACM_METRIC_HARDWARE_WAVE_INPUTとACM_METRIC_HARDWARE_WAVE_OUTPUTメトリック インデックスで acmMetrics 関数を使用して、サポートする ACM ドライバーに関連付けられている波形オーディオ デバイス識別子を取得する必要があります。 |
戻り値
コールバック関数は、列挙を続行するには TRUE を 返し、列挙を停止するには FALSE を 返す必要があります。
注釈
書式を列挙しない場合、 acmFormatEnum 関数はMMSYSERR_NOERROR (ゼロ) を返します。 さらに、コールバック関数は呼び出されません。
コールバック関数内から acmDriverAdd、acmDriverRemove、および acmDriverPriority の各関数を呼び出さないでください。
注意
msacm.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ACMFORMATENUMCB を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | msacm.h |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示