ACMFILTERENUMCBA 回呼函式 (msacm.h)

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

語法

ACMFILTERENUMCBA Acmfilterenumcba;

BOOL Acmfilterenumcba(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

參數

hadid

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

pafd

ACMFILTERDETAILS 結構的指標，其中包含篩選標記的列舉篩選詳細數據。

dwInstance

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

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 以停止列舉。

備註

如果未列舉任何篩選， acmFilterEnum 函式會傳回零MMSYSERR_NOERROR (零) 。 此外，不會呼叫回呼函式。

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

注意

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

規格需求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員