acmDriverEnum 関数 (msacm.h)

  • [アーティクル]

acmDriverEnum 関数は、使用可能な ACM ドライバーを列挙し、ドライバーがなくなったか、コールバック関数が FALSE を返すまで続行します。

構文

MMRESULT ACMAPI acmDriverEnum(
  ACMDRIVERENUMCB fnCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwEnum
);

パラメーター

fnCallback

アプリケーション定義コールバック関数のプロシージャ インスタンス アドレス。

dwInstance

ACM ドライバー情報と共にコールバック関数に渡される 64 ビット (DWORD_PTR) または 32 ビット (DWORD) アプリケーション定義値。

fdwEnum

ACM ドライバーを列挙するためのフラグ。 次の値が定義されています。

値 説明
ACM_DRIVERENUMF_DISABLED 無効な ACM ドライバーは、列挙に含める必要があります。 ドライバーは、ユーザーがلوحة التحكمまたは acmDriverPriority 関数を使用してアプリケーションによって無効にすることができます。 ドライバーが無効になっている場合、コールバック関数の fdwSupport パラメーターには、ACMDRIVERDETAILS_SUPPORTF_DISABLED フラグが設定されます。
ACM_DRIVERENUMF_NOLOCAL 列挙にはグローバル ドライバーのみを含める必要があります。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。

解説

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

要件

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

関連項目

オーディオ圧縮関数

オーディオ圧縮マネージャー