acmDriverEnum 函式 (msacm.h)
acmDriverEnum函式會列舉可用的 ACM 驅動程式,直到沒有其他驅動程式或回呼函式傳回FALSE為止。
語法
MMRESULT ACMAPI acmDriverEnum(
ACMDRIVERENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
參數
fnCallback
應用程式定義回呼函式的程式實例位址。
dwInstance
64 位 (DWORD_PTR) 或 32 位 (DWORD) 傳遞至回呼函式的應用程式定義值,以及 ACM 驅動程式資訊。
fdwEnum
列舉 ACM 驅動程式的旗標。 定義下列值。
值 | 意義 |
---|---|
ACM_DRIVERENUMF_DISABLED | 停用的 ACM 驅動程式應該包含在列舉中。 使用者可透過主控台或使用acmDriverPriority函式的應用程式停用驅動程式。 如果停用驅動程式,回呼函式的 fdwSupport 參數將會設定ACMDRIVERDETAILS_SUPPORTF_DISABLED旗標。 |
ACM_DRIVERENUMF_NOLOCAL | 列舉中應該只包含全域驅動程式。 |
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
傳回碼 | 描述 |
---|---|
|
至少有一個旗標無效。 |
|
至少有一個參數無效。 |
備註
如果未安裝 ACM 驅動程式, acmDriverEnum 函式會傳回MMSYSERR_NOERROR (零) 。 此外,不會呼叫回呼函式。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
程式庫 | Msacm32.lib |
Dll | Msacm32.dll |