Share via

acmDriverMessage 함수(msacm.h)

  • 아티클

acmDriverMessage 함수는 지정된 ACM 드라이버 instance 사용자 정의 메시지를 보냅니다.

구문

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

매개 변수

had

메시지를 보낼 ACM 드라이버 instance 대한 핸들입니다.

uMsg

ACM 드라이버가 처리해야 한다는 메시지입니다. 이 메시지는 ACMDM_USER 메시지 범위(ACMDM_USER 이상 및 ACMDM_RESERVED_LOW 미만)에 있어야 합니다. 이 제한에 대한 예외는 ACMDM_DRIVER_ABOUT, DRV_QUERYCONFIGURE 및 DRV_CONFIGURE 메시지입니다.

lParam1

메시지 매개 변수입니다.

lParam2

메시지 매개 변수입니다.

반환 값

반환 값은 uMsg 매개 변수로 지정된 사용자 정의 ACM 드라이버 메시지와 관련이 있습니다. 그러나 가능한 오류 값은 다음과 같습니다.

반환 코드 설명
MMSYSERR_INVALHANDLE
 지정한 핸들이 잘못되었습니다.
MMSYSERR_INVALPARAM
 uMsg 매개 변수가 ACMDM_USER 범위에 없습니다.
MMSYSERR_NOTSUPPORTED
 ACM 드라이버가 메시지를 처리하지 않았습니다.

설명

ACM 드라이버에서 사용자 지정 정보 대화 상자를 표시하려면 애플리케이션이 드라이버에 ACMDM_DRIVER_ABOUT 메시지를 보내야 합니다. lParam1 매개 변수는 사용자 지정 정보 대화 상자의 소유자 창 핸들이어야 하며 lParam2를 0으로 설정해야 합니다. 드라이버가 사용자 지정 정보 대화 상자를 지원하지 않는 경우 MMSYSERR_NOTSUPPORTED 반환되고 자체 대화 상자를 표시하는 것은 애플리케이션의 책임입니다. 예를 들어 제어판 소리 매퍼 옵션은 ACM 드라이버가 MMSYSERR_NOTSUPPORTED 반환할 때 ACMDRIVERDETAILS 구조에 따라 기본 정보 대화 상자를 표시합니다. 애플리케이션은 lParam1을 –1L 로 설정하여 대화 상자를 표시하지 않고도 드라이버에서 사용자 지정 정보 대화 상자 지원을 쿼리할 수 있습니다. 드라이버가 사용자 지정 정보 대화 상자를 지원하는 경우 MMSYSERR_NOERROR 반환됩니다. 그렇지 않으면 반환 값이 MMSYSERR_NOTSUPPORTED.

사용자 정의 메시지는 메시지를 특별히 지원하는 ACM 드라이버로만 보내야 합니다. 호출자는 드라이버 세부 정보를 검색하고 ACMDRIVERDETAILS 구조체의 wMid, wPid 및 vdwDriver 멤버를 확인하여 ACM 드라이버가 올바른 드라이버인지 확인해야 합니다.

알 수 없는 ACM 드라이버에 사용자 정의 메시지를 보내지 않습니다.

요구 사항

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

참고 항목

오디오 압축 함수

오디오 압축 관리자