acmDriverPriority 함수(msacm.h)
acmDriverPriority 함수는 ACM 드라이버의 우선 순위와 상태를 수정합니다.
구문
MMRESULT ACMAPI acmDriverPriority(
HACMDRIVERID hadid,
DWORD dwPriority,
DWORD fdwPriority
);
매개 변수
hadid
설치된 ACM 드라이버의 드라이버 식별자에 대한 핸들입니다. ACM_DRIVERPRIORITYF_BEGIN 및 ACM_DRIVERPRIORITYF_END 플래그를 지정하는 경우 이 매개 변수는 NULL이어야 합니다.
dwPriority
전역 ACM 드라이버 식별자에 대한 새 우선 순위입니다. 0 값은 드라이버 식별자의 우선 순위가 변경되지 않은 상태로 유지되도록 지정합니다. 값 1은 드라이버가 가장 높은 검색 우선 순위 드라이버로 배치되도록 지정합니다. –1 값은 드라이버를 가장 낮은 검색 우선 순위 드라이버로 배치해야 임을 지정합니다. 우선 순위는 전역 드라이버에만 사용됩니다.
fdwPriority
ACM 드라이버의 우선 순위를 설정하기 위한 플래그입니다. 다음 값이 정의됩니다.
| 값 | 의미 |
|---|---|
| ACM_DRIVERPRIORITYF_BEGIN | 변경 알림 브로드캐스트를 연기해야 합니다. 애플리케이션은 ACM_DRIVERPRIORITYF_END 플래그를 사용하여 가능한 한 빨리 알림 브로드캐스트를 다시 활성화해야 합니다. hadid는 NULL이어야 하고, dwPriority는 0이어야 하며, ACM_DRIVERPRIORITYF_BEGIN 플래그만 설정할 수 있습니다. |
| ACM_DRIVERPRIORITYF_DISABLE | 현재 사용하도록 설정된 경우 ACM 드라이버를 사용하지 않도록 설정해야 합니다. 비활성화된 드라이버를 사용하지 않도록 설정해도 아무 작업도 수행하지 않습니다. |
| ACM_DRIVERPRIORITYF_ENABLE | 현재 사용하지 않도록 설정된 경우 ACM 드라이버를 사용하도록 설정해야 합니다. 활성화된 드라이버를 사용하도록 설정해도 아무런 작업이 수행되지 않습니다. |
| ACM_DRIVERPRIORITYF_END | 호출 태스크는 변경 알림 브로드캐스트를 다시 활성화하려고 합니다. 애플리케이션은 ACM_DRIVERPRIORITYF_BEGIN 플래그를 사용하여 성공한 각 호출에 대해 ACM_DRIVERPRIORITYF_END acmDriverPriority 를 호출해야 합니다. hadid는 NULL이어야 하고, dwPriority는 0이어야 하며, ACM_DRIVERPRIORITYF_END 플래그만 설정할 수 있습니다. |
반환 값
성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다. 가능한 오류 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
지연된 브로드캐스트 잠금은 다른 작업에서 소유합니다. |
|
하나 이상의 플래그가 잘못되었습니다. |
|
지정한 핸들이 잘못되었습니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
요청된 작업은 지정된 드라이버에 대해 지원되지 않습니다. 예를 들어 로컬 및 알림 드라이버 식별자는 우선 순위를 지원하지 않지만 사용하도록 설정하고 사용하지 않도록 설정할 수 있습니다. 애플리케이션이 로컬 및 알림 드라이버 식별자에 대해 dwPriority 에 대해 0이 아닌 값을 지정하면 이 오류가 반환됩니다. |
설명
전역, 로컬 및 알림 드라이버 식별자를 포함하여 모든 드라이버 식별자를 사용하도록 설정하고 사용하지 않도록 설정할 수 있습니다.
둘 이상의 전역 드라이버 식별자를 사용하도록 설정하거나 사용하지 않도록 설정하거나 우선 순위로 이동해야 하는 경우 애플리케이션은 ACM_DRIVERPRIORITYF_BEGIN 플래그를 사용하여 변경 알림 브로드캐스트를 연기해야 합니다. ACM_DRIVERPRIORITYF_END 플래그를 지정하면 단일 변경 알림이 브로드캐스트됩니다.
애플리케이션은 acmMetrics ACM_METRIC_DRIVER_PRIORITY 메트릭 인덱스와 함께 함수를 사용하여 전역 드라이버의 현재 우선 순위를 검색할 수 있습니다. 드라이버는 항상 acmDriverEnum 함수에 의해 가장 높은 우선 순위에서 가장 낮은 우선 순위로 열거됩니다.
사용하도록 설정된 모든 드라이버 식별자는 변경 알림을 받습니다. 애플리케이션은 acmDriverAdd 함수를 ACM_DRIVERADDF_NOTIFYHWND 플래그와 함께 사용하여 알림 메시지를 등록할 수 있습니다. 비글로벌 드라이버 식별자에 대한 변경 내용은 브로드캐스트되지 않습니다.
우선 순위는 애플리케이션이 드라이버를 지정하지 않는 경우 검색 순서에만 사용됩니다. 드라이버의 우선 순위를 높이면 드라이버의 성능에 영향을 주지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | msacm.h |
| 라이브러리 | Msacm32.lib |
| DLL | Msacm32.dll |