ACMFORMATTAGENUMCB 回呼函式 (msacm.h)

  • 發行項

acmFormatTagEnumCallback函式會指定搭配acmFormatTagEnum函式使用的回呼函式。 acmFormatTagEnumCallback名稱是應用程式定義函數名稱的預留位置。

語法

ACMFORMATTAGENUMCB Acmformattagenumcb;

BOOL Acmformattagenumcb(
  HACMDRIVERID hadid,
  LPACMFORMATTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

參數

hadid

ACM 驅動程式識別碼的控制碼。

paftd

包含列舉格式標記詳細資料的 ACMFORMATTAGDETAILS 結構的指標。

dwInstance

acmFormatTagEnum函式中指定的應用程式定義值。

fdwSupport

驅動程式支援旗標專屬於格式標記。 這些旗標與 ACMDRIVERDETAILS 結構相同。 這個參數可以是下列值的組合，並指出驅動程式支援哪些作業搭配格式標記。

值 意義
ACMDRIVERDETAILS_SUPPORTF_ASYNC 驅動程式支援使用指定的篩選標籤進行非同步轉換。
ACMDRIVERDETAILS_SUPPORTF_CODEC 驅動程式支援在兩個不同的格式標記之間進行轉換，其中其中一個標記是指定的格式標記。 例如，如果驅動程式支援從WAVE_FORMAT_PCM壓縮到WAVE_FORMAT_ADPCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER 驅動程式支援在兩種不同格式的指定格式標記之間進行轉換。 例如，如果驅動程式支援重新取樣WAVE_FORMAT_PCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_FILTER 驅動程式支援篩選 (修改資料，而不需要變更任何格式屬性) 。 例如，如果驅動程式支援指定格式標籤上的磁片區或回應作業，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_HARDWARE 驅動程式透過電壓音訊裝置支援硬體輸入、輸出或兩者指定的格式標記。 應用程式應該使用 acmMetrics 搭配ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT計量索引，以取得與支援 ACM 驅動程式相關聯的電壓音訊裝置識別碼。

傳回值

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

備註

如果未列舉任何格式標記， 則 acmFormatTagEnum 函式會傳回零MMSYSERR_NOERROR (零) 。 此外，不會呼叫回呼函式。

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

需求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員