共用方式為

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

傳回值

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

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

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 msacm.h
連結庫 Msacm32.lib
DLL Msacm32.dll

另請參閱

音訊壓縮函式

音訊壓縮管理員