acmMetrics 函式 (msacm.h)

acmMetrics函式會傳回 ACM 或相關 ACM 物件的各種計量。

語法

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

參數

hao

ACM 物件的控制碼，以查詢 uMetric中指定的計量。 對於某些查詢，此參數可以是 Null。

uMetric

要以 pMetric傳回的計量索引。

值	意義
ACM_METRIC_COUNT_CODECS	傳回的值是系統中全域 ACM 冰箱或解壓縮器驅動程式的數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_CONVERTERS	傳回的值是系統中的全域 ACM 轉換器驅動程式數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_DISABLED	傳回的值是系統中所有支援類型) 的全域停用 ACM 驅動程式總數 (。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。 ACM_METRIC_COUNT_DRIVERS和ACM_METRIC_COUNT_DISABLED計量索引的總和是全域安裝的 ACM 驅動程式總數。
ACM_METRIC_COUNT_DRIVERS	傳回的值是系統中所有支援類型) 的已啟用全域 ACM 驅動程式總數 (。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_FILTERS	傳回的值是系統中的全域 ACM 篩選驅動程式數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_HARDWARE	傳回的值是系統中全域 ACM 硬體驅動程式的數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_CODECS	傳回的值是呼叫工作的本機 ACM 設備磁碟機、ACM 解壓縮器驅動程式或兩者的數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_CONVERTERS	傳回的值是呼叫工作的本機 ACM 轉換器驅動程式數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_DISABLED	傳回的值是呼叫工作所有支援類型的本機停用 ACM 驅動程式總數。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。 ACM_METRIC_COUNT_LOCAL_DRIVERS和ACM_METRIC_COUNT_LOCAL_DISABLED計量索引的總和是本機安裝的 ACM 驅動程式總數。
ACM_METRIC_COUNT_LOCAL_DRIVERS	傳回的值是呼叫工作的所有支援類型 (啟用的本機 ACM 驅動程式總數) 。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_FILTERS	傳回的值是呼叫工作的本機 ACM 篩選驅動程式數目。 此計量索引的 一個參數 必須是 Null 。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_DRIVER_PRIORITY	傳回的值是指定之驅動程式的目前優先順序。 連線參數必須是HACMDRIVERID資料類型的有效 ACM 驅動程式識別碼。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_DRIVER_SUPPORT	傳回的值是指定之驅動程式的 fdwSupport 旗標。 連線參數必須是HACMDRIVERID資料類型的有效 ACM 驅動程式識別碼。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_HARDWARE_WAVE_INPUT	傳回的值是與指定驅動程式相關聯的電壓音訊輸入裝置識別碼。 ACMDRIVERDETAILS_SUPPORTF_HARDWARE旗標的HACMDRIVERID資料類型必須是有效的 ACM 驅動程式識別碼。 如果沒有與驅動程式相關聯的波音訊輸入裝置，則會傳回MMSYSERR_NOTSUPPORTED。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_HARDWARE_WAVE_OUTPUT	傳回的值是與指定驅動程式相關聯的電壓音訊輸出設備識別碼。 ACMDRIVERDETAILS_SUPPORTF_HARDWARE旗標的HACMDRIVERID資料類型必須是有效的 ACM 驅動程式識別碼。 如果沒有與驅動程式相關聯的波音訊輸出裝置，則會傳回MMSYSERR_NOTSUPPORTED。 pMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_MAX_SIZE_FILTER	傳回的值是最大 WAVEFILTER 結構的大小。 如果為Null，則傳回值是系統中最大的WAVEFILTER結構。 如果識別HACMDRIVER資料類型的 ACM 驅動程式開啟實例，或HACMDRIVERID資料類型的 ACM 驅動程式識別碼，則會傳回該驅動程式的最大WAVEFILTER結構。 pMetric參數必須指向大小等於DWORD值的緩衝區。 HACMSTREAM資料類型的 ACM 資料流程控制碼不允許此計量。
ACM_METRIC_MAX_SIZE_FORMAT	傳回的值是最大一個的顯示位置。」 如果 able 為 Null，則傳回值是系統中最大的 一個顯示型別 X 結構。 如果 一個 識別 HACMDRIVER 資料類型的 ACM 驅動程式開啟實例，或 HACMDRIVERID 資料類型的 ACM 驅動程式識別碼，則會傳回該驅動程式的最大 一個的一個 BLOB 結構。 pMetric參數必須指向大小等於DWORD值的緩衝區。 HACMSTREAM資料類型的 ACM 資料流程控制碼不允許此計量。

pMetric

要接收計量詳細資料的緩衝區指標。 確切的定義取決於 uMetric 索引。

傳回值

如果成功或發生錯誤，則傳回零。 可能的錯誤值包括下列專案。

傳回碼	描述
ACMERR_NOTPOSSIBLE	在 uMetric中指定的索引無法傳回指定的 。
MMSYSERR_INVALHANDLE	指定的控制碼無效。
MMSYSERR_INVALPARAM	至少有一個參數無效。
MMSYSERR_NOTSUPPORTED	不支援 uMetric 中指定的索引。

需求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員