ACMFORMATENUMCB 回呼函式 (msacm.h)
acmFormatEnumCallback函式會指定與acmFormatEnum函式搭配使用的回呼函式。 acmFormatEnumCallback名稱是應用程式定義函數名稱的預留位置。
語法
ACMFORMATENUMCB Acmformatenumcb;
BOOL Acmformatenumcb(
HACMDRIVERID hadid,
LPACMFORMATDETAILS pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
參數
hadid
ACM 驅動程式識別碼的控制碼。
pafd
ACMFORMATDETAILS結構的指標，其中包含格式標記的列舉格式詳細資料。
dwInstance
acmFormatEnum函式中指定的應用程式定義值。
fdwSupport
驅動程式支援 ACMDRIVERDETAILS 結構所識別之驅動程式專屬的旗標，但它們是列舉格式特有的。 這個參數可以是下列值的組合，並指出驅動程式支援的格式標記作業。
| 值 | 意義 |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | 驅動程式支援使用指定的篩選標籤進行非同步轉換。 |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | Driver 支援在指定格式的兩個不同格式標記之間進行轉換。 例如，如果驅動程式支援從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。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | msacm.h |