ACMDRIVERENUMCB 回呼函式 (msacm.h)

acmDriverEnumCallback 函式會指定搭配 acmDriverEnum 函式使用的回呼函式。 acmDriverEnumCallback 名稱是應用程式定義函數名稱的佔位元。

語法

ACMDRIVERENUMCB Acmdriverenumcb;

BOOL Acmdriverenumcb(
  HACMDRIVERID hadid,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

hadid

ACM 驅動程式識別碼的句柄。

dwInstance

acmDriverEnum 中指定的應用程式定義值。

fdwSupport

ACMDRIVERDETAILS 結構所指定之驅動程式特有的驅動程序支援旗標。此參數可以是下列值的組合。

值	意義
ACMDRIVERDETAILS_SUPPORTF_ASYNC	驅動程式支援異步轉換。
ACMDRIVERDETAILS_SUPPORTF_CODEC	驅動程式支援在兩個不同的格式標記之間進行轉換。例如，如果驅動程式支援從WAVE_FORMAT_PCM壓縮到WAVE_FORMAT_ADPCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	驅動程式支援在相同格式標記的兩種不同格式之間進行轉換。例如，如果驅動程式支援重新取樣WAVE_FORMAT_PCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_DISABLED	驅動程式已停用。應用程式必須使用 acmDriverEnum 指定ACM_DRIVERENUMF_DISABLED旗標，才能在列舉中包含停用的驅動程式。
ACMDRIVERDETAILS_SUPPORTF_FILTER	驅動程式支援篩選 (修改數據，而不需要變更任何格式屬性) 。例如，如果驅動程式支援WAVE_FORMAT_PCM上的磁碟區或回應作業，則會設定此旗標。

回呼函式必須傳回 TRUE 才能繼續列舉或 FALSE 以停止列舉。

如果未安裝 ACM 驅動程式， acmDriverEnum 函式會傳回MMSYSERR_NOERROR (零) 。此外，不會呼叫回呼函式。

不應該從回呼函式內呼叫下列函式： acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。

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