共用方式為

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 旗標。 所有其他旗標都需要將此成員設定為零。

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 函式的描述。

傳回值

如果成功或發生錯誤，則傳回零。 可能的錯誤值包括下列專案。

傳回碼 Description
MMSYSERR_INVALFLAG
 至少有一個旗標無效。
MMSYSERR_INVALPARAM
 至少有一個參數無效。
MMSYSERR_NOMEM
 系統無法配置資源。

備註

注意

msacm.h 標頭會根據 UNICODE 預處理器常數的定義，將 acmDriverAdd 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 msacm.h
程式庫 Msacm32.lib
Dll Msacm32.dll

另請參閱

音訊壓縮函式

音訊壓縮管理員