次の方法で共有

acmDriverAddA 関数 (msacm.h)

  • [アーティクル]

acmDriverAdd 関数は、使用可能な ACM ドライバーの一覧にドライバーを追加します。 ドライバーの種類と場所は、ACM ドライバーの追加に使用されるフラグによって異なります。 ドライバーが正常に追加されると、ドライバー エントリ関数は ACM ドライバー メッセージを受信します。

構文

MMRESULT ACMAPI acmDriverAddA(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

パラメーター

phadid

インストールされているドライバーを識別するハンドルを受け取るバッファーへのポインター。 このハンドルは、他の ACM 関数の呼び出しでドライバーを識別するために使用されます。

hinstModule

実行可能ファイルまたはダイナミック リンク ライブラリ (DLL) にドライバー エントリ関数が含まれているモジュールのインスタンスへのハンドル。

lParam

fdwAdd フラグに応じて、ドライバー関数アドレスまたは通知ウィンドウ ハンドル。

dwPriority

通知ブロードキャスト用に送信するウィンドウ メッセージ。 このパラメーターは、ACM_DRIVERADDF_NOTIFYHWND フラグでのみ使用されます。 他のすべてのフラグでは、このメンバーを 0 に設定する必要があります。

fdwAdd

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

価値 意味
ACM_DRIVERADDF_FUNCTION lParam パラメーターは、acmDriverProc プロトタイプに準拠するドライバー関数アドレスです。 この関数は、実行可能ファイルまたは DLL ファイルに存在する場合があります。
ACM_DRIVERADDF_GLOBAL 16 ビット アプリケーションとの互換性のために提供されます。 Win32 API の場合、acmDriverAdd 関数によって追加された ACM ドライバーは、ドライバーを追加したアプリケーションでのみ使用できます。 これは、ACM_DRIVERADDF_GLOBALが指定されているかどうかに関係なく当てはまります。 詳細については、「アプリケーション内でのドライバーの追加」を参照してください。
ACM_DRIVERADDF_LOCAL ACM は、関数呼び出しを満たすためにドライバーを検索するときに、グローバル ドライバーよりもローカル ドライバーの優先度が自動的に高くなります。 詳細については、「アプリケーション内でのドライバーの追加」を参照してください。
ACM_DRIVERADDF_NAME lParam パラメーターは、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32のレジストリ値の名前です。 この値は、ACM コーデックを実装する DLL を識別します。 アプリケーションで ACM の使用が既に開始された後に新しいレジストリ エントリが作成された場合、アプリケーションはこのフラグを使用できます。
ACM_DRIVERADDF_NOTIFYHWND lParam パラメーターは、グローバル ドライバーの優先順位と状態に変更が加えられたときにメッセージを受信する通知ウィンドウのハンドルです。 受信するウィンドウ メッセージはアプリケーションによって定義され、dwPriority渡す必要があります。 ウィンドウ メッセージと共に渡される wParam および lParam パラメーターは、将来使用するために予約されており、無視する必要があります。 ACM_DRIVERADDF_GLOBALこのフラグと組み合わせて指定することはできません。 ドライバーの優先順位の詳細については、acmDriverPriority 関数の説明を参照してください。

戻り値

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

リターン コード 形容
MMSYSERR_INVALFLAG
 少なくとも 1 つのフラグが無効です。
MMSYSERR_INVALPARAM
 少なくとも 1 つのパラメーターが無効です。
MMSYSERR_NOMEM
 システムはリソースを割り当てることができません。

備考

手記

msacm.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして acmDriverAdd を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msacm.h
ライブラリ Msacm32.lib
DLL Msacm32.dll

関連項目

オーディオ圧縮機能 を する

Audio Compression Manager