共用方式為


ACMFILTERENUMCBW 回調函式 (msacm.h)

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

語法

ACMFILTERENUMCBW Acmfilterenumcbw;

BOOL Acmfilterenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSW 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 (零)。 此外,不會呼叫回呼函式。

在回呼函式中不應該呼叫下列函式:acmDriverAddacmDriverRemoveacmDriverPriority

注意

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

要求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員