ACMFORMATENUMCBA 回呼函式 (msacm.h)
acmFormatEnumCallback 函式會指定與 acmFormatEnum 函式搭配使用的回呼函式。 acmFormatEnumCallback 名稱是應用程式定義函數名稱的佔位符。
語法
ACMFORMATENUMCBA Acmformatenumcba;
BOOL Acmformatenumcba(
HACMDRIVERID hadid,
LPACMFORMATDETAILSA pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
參數
hadid
ACM 驅動程式識別碼的句柄。
pafd
ACMFORMATDETAILS 結構的指標,其中包含格式標記的列舉格式詳細數據。
dwInstance
acmFormatEnum 函式中指定的應用程式定義值。
fdwSupport
驅動程式支援 ACMDRIVERDETAILS 結構所識別之驅動程式特有的旗標,但其專屬於所列舉的格式。 此參數可以是下列值的組合,並指出驅動程序支援的格式標記作業。
值 | 意義 |
---|---|
ACMDRIVERDETAILS_SUPPORTF_ASYNC | 驅動程式支援使用指定的篩選標記進行異步轉換。 |
ACMDRIVERDETAILS_SUPPORTF_CODEC | 驅動程式支援在指定格式的兩個不同格式標記之間進行轉換。 例如,如果驅動程式支援從WAVE_FORMAT_PCM壓縮到具有指定格式的WAVE_FORMAT_ADPCM,則會設定此旗標。 |
ACMDRIVERDETAILS_SUPPORTF_CONVERTER | 驅動程式支援使用指定格式時,在相同格式標記的兩種不同格式之間進行轉換。 例如,如果驅動程式支援將WAVE_FORMAT_PCM重新取樣為指定的格式,則會設定此旗標。 |
ACMDRIVERDETAILS_SUPPORTF_FILTER | 驅動程式支援篩選 (修改數據,而不需變更具有指定格式的任何格式屬性) 。 例如,如果驅動程式支援WAVE_FORMAT_PCM上的磁碟區或回應作業,則會設定此旗標。 |
ACMDRIVERDETAILS_SUPPORTF_HARDWARE | 驅動程式支援透過電壓音訊裝置的硬體輸入、輸出或兩個指定格式標記。 應用程式應該使用 acmMetrics 函式搭配ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT計量索引,以取得與支援 ACM 驅動程式相關聯的波音頻裝置標識碼。 |
傳回值
回呼函式必須傳回 TRUE ,才能繼續列舉或 FALSE 以停止列舉。
備註
如果沒有列舉任何格式, acmFormatEnum 函式會傳回零MMSYSERR_NOERROR (零) 。 此外,不會呼叫回呼函式。
下列函式不應從回呼函式內呼叫: acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。
注意
msacm.h 標頭會根據 UNICODE 預處理器常數的定義,將 ACMFORMATENUMCB 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應