다음을 통해 공유

acmDriverAdd 함수(msacm.h)

  • 아티클

acmDriverAdd 함수는 사용 가능한 ACM 드라이버 목록에 드라이버를 추가합니다. 드라이버 유형 및 위치는 ACM 드라이버를 추가하는 데 사용되는 플래그에 따라 달라집니다. 드라이버가 성공적으로 추가되면 드라이버 항목 함수는 ACM 드라이버 메시지를 받습니다.

구문

MMRESULT ACMAPI acmDriverAdd(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

매개 변수

phadid

설치된 드라이버를 식별하는 핸들을 수신하는 버퍼에 대한 포인터입니다. 이 핸들은 다른 ACM 함수 호출에서 드라이버를 식별하는 데 사용됩니다.

hinstModule

실행 파일 또는 DLL(동적 링크 라이브러리)에 드라이버 항목 함수가 포함된 모듈의 instance 대한 핸들입니다.

lParam

fdwAdd 플래그에 따라 드라이버 함수 주소 또는 알림 창 핸들입니다.

dwPriority

알림 브로드캐스트를 위해 보낼 창 메시지입니다. 이 매개 변수는 ACM_DRIVERADDF_NOTIFYHWND 플래그에만 사용됩니다. 다른 모든 플래그는 이 멤버를 0으로 설정해야 합니다.

fdwAdd

ACM 드라이버를 추가하기 위한 플래그입니다. 다음 값이 정의됩니다.

값 의미
ACM_DRIVERADDF_FUNCTION lParam 매개 변수는 acmDriverProc 프로토타입을 준수하는 드라이버 함수 주소입니다. 함수는 실행 파일 또는 DLL 파일에 있을 수 있습니다.
ACM_DRIVERADDF_GLOBAL 16비트 애플리케이션과의 호환성을 위해 제공됩니다. Win32 API의 경우 acmDriverAdd 함수에 의해 추가된 ACM 드라이버는 드라이버를 추가한 애플리케이션에서만 사용할 수 있습니다. ACM_DRIVERADDF_GLOBAL 지정되었는지 여부에 관계없이 마찬가지입니다. 자세한 내용은 애플리케이션 내에서 드라이버 추가를 참조하세요.
ACM_DRIVERADDF_LOCAL ACM은 함수 호출을 충족할 드라이버를 검색할 때 로컬 드라이버에 전역 드라이버보다 더 높은 우선 순위를 자동으로 부여합니다. 자세한 내용은 애플리케이션 내에서 드라이버 추가를 참조하세요.
ACM_DRIVERADDF_NAME lParam 매개 변수는 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32 레지스트리 값 이름입니다. 값은 ACM 코덱을 구현하는 DLL을 식별합니다. 애플리케이션이 이미 ACM을 사용하기 시작한 후 새 레지스트리 항목이 만들어지면 애플리케이션에서 이 플래그를 사용할 수 있습니다.
ACM_DRIVERADDF_NOTIFYHWND lParam 매개 변수는 전역 드라이버 우선 순위 및 상태가 변경될 때 메시지를 수신하는 알림 창의 핸들입니다. 수신할 창 메시지는 애플리케이션에 의해 정의되며 dwPriority로 전달되어야 합니다. 창 메시지와 함께 전달된 wParam 및 lParam 매개 변수는 나중에 사용하도록 예약되어 있으며 무시해야 합니다. ACM_DRIVERADDF_GLOBAL 이 플래그와 함께 지정할 수 없습니다. 드라이버 우선 순위에 대한 자세한 내용은 acmDriverPriority 함수에 대한 설명을 참조하세요.

반환 값

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

반환 코드 설명
MMSYSERR_INVALFLAG
 하나 이상의 플래그가 잘못되었습니다.
MMSYSERR_INVALPARAM
 하나 이상의 매개 변수가 잘못되었습니다.
MMSYSERR_NOMEM
 시스템에서 리소스를 할당할 수 없습니다.

요구 사항

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

참고 항목

오디오 압축 함수

오디오 압축 관리자