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

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

構文

ACMDRIVERENUMCB Acmdriverenumcb;

BOOL Acmdriverenumcb(
  HACMDRIVERID hadid,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

hadid

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

dwInstance

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

fdwSupport

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でボリューム操作またはエコー操作をサポートしている場合、このフラグが設定されます。

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

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

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

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