Share via

ACMFILTERENUMCBA 콜백 함수(msacm.h)

  • 아티클

acmFilterEnumCallback 함수는 acmFilterEnum 함수와 함께 사용되는 콜백 함수를 지정합니다. acmFilterEnumCallback 이름은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

ACMFILTERENUMCBA Acmfilterenumcba;

BOOL Acmfilterenumcba(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

매개 변수

hadid

ACM 드라이버 식별자에 대한 핸들입니다.

pafd

필터 태그에 대한 열거형 필터 세부 정보가 포함된 ACMFILTERDETAILS 구조체에 대한 포인터입니다.

dwInstance

acmFilterEnum에 지정된 애플리케이션 정의 값입니다.

fdwSupport

ACMDRIVERDETAILS 구조체로 식별되는 드라이버와 관련된 드라이버 지원 플래그이지만 열거 중인 필터와 관련이 있습니다. 이 매개 변수는 다음 값의 조합일 수 있으며 드라이버가 필터 태그에 대해 지원하는 작업을 식별합니다.

값 의미
ACMDRIVERDETAILS_SUPPORTF_ASYNC 드라이버는 지정된 필터 태그를 사용하여 비동기 변환을 지원합니다.
ACMDRIVERDETAILS_SUPPORTF_CODEC 드라이버는 지정된 필터를 사용하는 동안 서로 다른 두 형식 태그 간의 변환을 지원합니다. 예를 들어 드라이버가 지정된 필터를 사용하여 WAVE_FORMAT_PCM WAVE_FORMAT_ADPCM 압축을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER 드라이버는 지정된 필터를 사용하는 동안 동일한 형식 태그의 서로 다른 두 형식 간 변환을 지원합니다. 예를 들어 드라이버가 지정된 필터를 사용하여 WAVE_FORMAT_PCM 다시 샘플링을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_FILTER 드라이버는 필터를 지원합니다(형식 특성을 변경하지 않고 데이터 수정). 예를 들어 드라이버가 WAVE_FORMAT_PCM 볼륨 또는 에코 작업을 지원하는 경우 이 플래그가 설정됩니다.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE 드라이버는 파형 오디오 디바이스를 통해 지정된 필터를 사용하여 하드웨어 입력, 출력 또는 둘 다를 지원합니다. 애플리케이션은 acmMetrics 함수를 ACM_METRIC_HARDWARE_WAVE_INPUT 및 ACM_METRIC_HARDWARE_WAVE_OUTPUT 메트릭 인덱스와 함께 사용하여 지원 ACM 드라이버와 연결된 파형 오디오 디바이스 식별자를 가져와야 합니다.

반환 값

콜백 함수는 열거를 계속하려면 TRUE 를 반환하고, 열거를 중지하려면 FALSE 를 반환해야 합니다.

설명

열거할 필터가 없으면 acmFilterEnum 함수는 MMSYSERR_NOERROR(0)를 반환합니다. 또한 콜백 함수는 호출되지 않습니다.

콜백 함수 내에서 acmDriverAdd, acmDriverRemove 및 acmDriverPriority 함수를 호출하면 안 됩니다.

참고

msacm.h 헤더는 ACMFILTERENUMCB를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 msacm.h

추가 정보

오디오 압축 함수

오디오 압축 관리자