ACMDRIVERENUMCB

コールバック

シグネチャ

BOOL ACMDRIVERENUMCB(
    HACMDRIVERID hadid,
    UINT_PTR dwInstance,
    DWORD fdwSupport
);

パラメーター

フィールド

型

説明

hadid

HACMDRIVERID

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

dwInstance

UINT_PTR

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

fdwSupport

DWORD

ACMDRIVERDETAILS 構造体で指定されたドライバーに固有の、ドライバーサポートフラグ。このパラメーターには、次の値の組み合わせを指定できます。

値	意味
ACMDRIVERDETAILS_SUPPORTF_ASYNC	ドライバーは非同期の変換をサポートします。
ACMDRIVERDETAILS_SUPPORTF_CODEC	ドライバーは、異なる 2 つのフォーマットタグ間の変換をサポートします。たとえば、ドライバーが WAVE_FORMAT_PCM から WAVE_FORMAT_ADPCM への圧縮をサポートする場合、このフラグが設定されます。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	ドライバーは、同じフォーマットタグ内の異なる 2 つのフォーマット間の変換をサポートします。たとえば、ドライバーが WAVE_FORMAT_PCM のリサンプリングをサポートする場合、このフラグが設定されます。
ACMDRIVERDETAILS_SUPPORTF_DISABLED	ドライバーは無効化されています。無効化されたドライバーを列挙に含めるには、アプリケーションは acmDriverEnum に ACM_DRIVERENUMF_DISABLED フラグを指定する必要があります。
ACMDRIVERDETAILS_SUPPORTF_FILTER	ドライバーはフィルター (フォーマット属性を変更せずにデータを加工する処理) をサポートします。たとえば、ドライバーが WAVE_FORMAT_PCM に対する音量やエコーの操作をサポートする場合、このフラグが設定されます。

公式ドキュメント

acmDriverEnumCallback 関数は、acmDriverEnum 関数と共に使用されるコールバック関数を指定します。acmDriverEnumCallback という名前は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

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

解説(Remarks)

ACM ドライバーが 1 つもインストールされていない場合、acmDriverEnum 関数は MMSYSERR_NOERROR (ゼロ) を返します。また、その場合コールバック関数は呼び出されません。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)