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 드라이버 메시지와 관련이 있습니다. 그러나 가능한 오류 값은 다음과 같습니다.
반환 코드 | 설명 |
---|---|
|
지정한 핸들이 잘못되었습니다. |
|
uMsg 매개 변수가 ACMDM_USER 범위에 없습니다. |
|
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 |