共用方式為


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 冰箱或解壓縮器驅動程式的數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_CONVERTERS 傳回的值是系統中的全域 ACM 轉換器驅動程式數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_DISABLED 傳回的值是系統中所有支援類型) 的全域停用 ACM 驅動程式總數 (。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。 ACM_METRIC_COUNT_DRIVERS和ACM_METRIC_COUNT_DISABLED計量索引的總和是全域安裝的 ACM 驅動程式總數。
ACM_METRIC_COUNT_DRIVERS 傳回的值是系統中所有支援類型) 的已啟用全域 ACM 驅動程式總數 (。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_FILTERS 傳回的值是系統中的全域 ACM 篩選驅動程式數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_HARDWARE 傳回的值是系統中全域 ACM 硬體驅動程式的數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_CODECS 傳回的值是呼叫工作的本機 ACM 設備磁碟機、ACM 解壓縮器驅動程式或兩者的數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_CONVERTERS 傳回的值是呼叫工作的本機 ACM 轉換器驅動程式數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_DISABLED 傳回的值是呼叫工作所有支援類型的本機停用 ACM 驅動程式總數。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。 ACM_METRIC_COUNT_LOCAL_DRIVERS和ACM_METRIC_COUNT_LOCAL_DISABLED計量索引的總和是本機安裝的 ACM 驅動程式總數。
ACM_METRIC_COUNT_LOCAL_DRIVERS 傳回的值是呼叫工作的所有支援類型 (啟用的本機 ACM 驅動程式總數) 。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於DWORD值的緩衝區。
ACM_METRIC_COUNT_LOCAL_FILTERS 傳回的值是呼叫工作的本機 ACM 篩選驅動程式數目。 此計量索引的 一個參數 必須是 NullpMetric參數必須指向大小等於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 傳回的值是最大一個的顯示位置。」 如果 ableNull,則傳回值是系統中最大的 一個顯示型別 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

另請參閱

音訊壓縮函式

音訊壓縮管理員