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 |