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

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

傳回值

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

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

需求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員