다음을 통해 공유

acmMetrics 함수(msacm.h)

  • 아티클

acmMetrics 함수는 ACM 또는 관련 ACM 개체에 대한 다양한 메트릭을 반환합니다.

구문

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

매개 변수

hao

uMetric에 지정된 메트릭을 쿼리할 ACM 개체에 대한 핸들입니다. 일부 쿼리의 경우 이 매개 변수는 NULL일 수 있습니다.

uMetric

pMetric에서 반환할 메트릭 인덱 스입니다.

값 의미
ACM_METRIC_COUNT_CODECS 반환된 값은 시스템의 전역 ACM 압축기 또는 압축 해제기 드라이버 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_CONVERTERS 반환된 값은 시스템의 전역 ACM 변환기 드라이버 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_DISABLED 반환된 값은 시스템에서 전역 비활성화된 ACM 드라이버(모든 지원 유형)의 총 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다. ACM_METRIC_COUNT_DRIVERS 및 ACM_METRIC_COUNT_DISABLED 메트릭 인덱스의 합계는 전역적으로 설치된 ACM 드라이버의 총 수입니다.
ACM_METRIC_COUNT_DRIVERS 반환된 값은 시스템에서 활성화된 전역 ACM 드라이버(모든 지원 유형)의 총 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_FILTERS 반환된 값은 시스템의 전역 ACM 필터 드라이버 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_HARDWARE 반환된 값은 시스템의 전역 ACM 하드웨어 드라이버 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_LOCAL_CODECS 반환된 값은 호출 작업에 대한 로컬 ACM 압축기 드라이버, ACM 압축 해제기 드라이버 또는 둘 다의 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_LOCAL_CONVERTERS 반환된 값은 호출 작업에 대한 로컬 ACM 변환기 드라이버의 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_LOCAL_DISABLED 반환된 값은 호출 작업에 대한 모든 지원 형식의 로컬 비활성화 ACM 드라이버의 총 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다. ACM_METRIC_COUNT_LOCAL_DRIVERS 및 ACM_METRIC_COUNT_LOCAL_DISABLED 메트릭 인덱스의 합계는 로컬에 설치된 ACM 드라이버의 총 수입니다.
ACM_METRIC_COUNT_LOCAL_DRIVERS 반환된 값은 호출 작업에 대해 활성화된 로컬 ACM 드라이버(모든 지원 유형)의 총 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_COUNT_LOCAL_FILTERS 반환된 값은 호출 작업에 대한 로컬 ACM 필터 드라이버의 수입니다. hao 매개 변수는 이 메트릭 인덱스에서 NULL이어야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_DRIVER_PRIORITY 반환된 값은 지정된 드라이버의 현재 우선 순위입니다. hao 매개 변수는 HACMDRIVERID 데이터 형식의 유효한 ACM 드라이버 식별자여야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_DRIVER_SUPPORT 반환된 값은 지정된 드라이버에 대한 fdwSupport 플래그입니다. hao 매개 변수는 HACMDRIVERID 데이터 형식의 유효한 ACM 드라이버 식별자여야 합니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_HARDWARE_WAVE_INPUT 반환된 값은 지정된 드라이버와 연결된 파형 오디오 입력 디바이스 식별자입니다. hao 매개 변수는 ACMDRIVERDETAILS_SUPPORTF_HARDWARE 플래그를 지원하는 HACMDRIVERID 데이터 형식의 유효한 ACM 드라이버 식별자여야 합니다. 드라이버와 연결된 파형 오디오 입력 디바이스가 없으면 MMSYSERR_NOTSUPPORTED 반환됩니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_HARDWARE_WAVE_OUTPUT 반환된 값은 지정된 드라이버와 연결된 파형 오디오 출력 디바이스 식별자입니다. hao 매개 변수는 ACMDRIVERDETAILS_SUPPORTF_HARDWARE 플래그를 지원하는 HACMDRIVERID 데이터 형식의 유효한 ACM 드라이버 식별자여야 합니다. 드라이버와 연결된 파형 오디오 출력 디바이스가 없으면 MMSYSERR_NOTSUPPORTED 반환됩니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다.
ACM_METRIC_MAX_SIZE_FILTER 반환된 값은 가장 큰 WAVEFILTER 구조체의 크기입니다. hao가 NULL인 경우 반환 값은 시스템에서 가장 큰 WAVEFILTER 구조체입니다. hao가 HACMDRIVER 데이터 형식의 ACM 드라이버의 열린 instance 또는 HACMDRIVERID 데이터 형식의 ACM 드라이버 식별자를 식별하는 경우 해당 드라이버에 대한 가장 큰 WAVEFILTER 구조가 반환됩니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다. HACMSTREAM 데이터 형식의 ACM 스트림 핸들에는 이 메트릭이 허용되지 않습니다.
ACM_METRIC_MAX_SIZE_FORMAT 반환된 값은 가장 큰 WAVEFORMATEX 구조체의 크기입니다. hao가 NULL인 경우 반환 값은 시스템에서 가장 큰 WAVEFORMATEX 구조체입니다. hao가 HACMDRIVER 데이터 형식의 ACM 드라이버의 열린 instance 또는 HACMDRIVERID 데이터 형식의 ACM 드라이버 식별자를 식별하는 경우 해당 드라이버에 대한 가장 큰 WAVEFORMATEX 구조가 반환됩니다. pMetric 매개 변수는 DWORD 값과 같은 크기의 버퍼를 가리킵니다. HACMSTREAM 데이터 형식의 ACM 스트림 핸들에는 이 메트릭이 허용되지 않습니다.

pMetric

메트릭 세부 정보를 수신할 버퍼에 대한 포인터입니다. 정확한 정의는 uMetric 인덱스에 따라 달라집니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
ACMERR_NOTPOSSIBLE
 uMetric에 지정된 인덱스가 지정된 hao에 대해 반환될 수 없습니다.
MMSYSERR_INVALHANDLE
 지정한 핸들이 잘못되었습니다.
MMSYSERR_INVALPARAM
 하나 이상의 매개 변수가 잘못되었습니다.
MMSYSERR_NOTSUPPORTED
 uMetric에 지정된 인덱스는 지원되지 않습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 msacm.h
라이브러리 Msacm32.lib
DLL Msacm32.dll

참고 항목

오디오 압축 함수

오디오 압축 관리자