acmDriverAdd 関数 (msacm.h)
acmDriverAdd 関数は、使用可能な ACM ドライバーの一覧にドライバーを追加します。 ドライバーの種類と場所は、ACM ドライバーの追加に使用されるフラグによって異なります。 ドライバーが正常に追加されると、ドライバーエントリ関数は ACM ドライバー メッセージを受信します。
構文
MMRESULT ACMAPI acmDriverAdd(
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 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
少なくとも 1 つのフラグが無効です。 |
|
少なくとも 1 つのパラメーターが無効です。 |
|
システムはリソースを割り当てることができません。 |
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msacm.h |
| Library | Msacm32.lib |
| [DLL] | Msacm32.dll |