acmFormatSuggest 함수(msacm.h)

acmFormatSuggest 함수는 ACM 또는 지정된 ACM 드라이버를 쿼리하여 제공된 원본 형식에 대한 대상 형식을 제안합니다. 예를 들어 애플리케이션은 이 함수를 사용하여 압축된 형식을 압축 해제할 수 있는 하나 이상의 유효한 PCM 형식을 결정할 수 있습니다.

구문

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

매개 변수

had

드라이버의 열린 instance 처리하여 제안된 대상 형식을 쿼리합니다. 이 매개 변수가 NULL인 경우 ACM은 대상 형식을 제안하는 가장 적합한 드라이버를 찾으려고 시도합니다.

pwfxSrc

ACM 또는 지정된 드라이버에서 대상 형식을 제안할 원본 형식을 식별하는 WAVEFORMATEX 구조체에 대한 포인터입니다.

pwfxDst

pwfxSrc 형식에 대해 제안된 대상 형식을 받을 WAVEFORMATEX 구조체에 대한 포인터입니다. fdwSuggest 매개 변수에 따라 pwfxDst가 가리키는 구조체의 일부 멤버는 초기화가 필요할 수 있습니다.

cbwfxDst

대상 형식에 사용할 수 있는 크기(바이트)입니다. acmMetrics 및 acmFormatTagDetails 함수를 사용하여 지정된 드라이버(또는 설치된 모든 ACM 드라이버)에 사용할 수 있는 모든 형식에 필요한 최대 크기를 결정할 수 있습니다.

fdwSuggest

원하는 대상 형식을 일치시키는 플래그입니다. 다음 값이 정의됩니다.

값	의미
ACM_FORMATSUGGESTF_NCHANNELS	pwfxDst가 가리키는 구조체의 nChannels 멤버가 유효합니다. ACM은 nChannels 와 일치하는 대상 형식을 제안하거나 실패할 수 있는 허용되는 설치된 드라이버를 쿼리합니다.
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	pwfxDst가 가리키는 구조체의 nSamplesPerSec 멤버가 유효합니다. ACM은 nSamplesPerSec 과 일치하는 대상 형식을 제안하거나 실패할 수 있는 허용되는 설치된 드라이버를 쿼리합니다.
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	pwfxDst가 가리키는 구조체의 wBitsPerSample 멤버가 유효합니다. ACM은 wBitsPerSample 과 일치하는 대상 형식을 제안하거나 실패할 수 있는 허용되는 설치된 드라이버를 쿼리합니다.
ACM_FORMATSUGGESTF_WFORMATTAG	pwfxDst가 가리키는 구조체의 wFormatTag 멤버가 유효합니다. ACM은 wFormatTag 와 일치하는 대상 형식을 제안하거나 실패할 수 있는 허용되는 설치된 드라이버를 쿼리합니다.

반환 값

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

반환 코드	설명
MMSYSERR_INVALFLAG	하나 이상의 플래그가 잘못되었습니다.
MMSYSERR_INVALHANDLE	지정한 핸들이 잘못되었습니다.
MMSYSERR_INVALPARAM	하나 이상의 매개 변수가 잘못되었습니다.

요구 사항

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

참고 항목

오디오 압축 함수

오디오 압축 관리자