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 |