IAudioSessionControl::SetIconPath 메서드(audiopolicy.h)

SetIconPath 메서드는 현재 세션에 표시 아이콘을 할당합니다.

구문

HRESULT SetIconPath(
  [in] LPCWSTR Value,
  [in] LPCGUID EventContext
);

매개 변수

[in] Value

아이콘이 포함된 .ico, .dll 또는 .exe 파일의 경로 및 파일 이름을 지정하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 아이콘 경로에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

[in] EventContext

이벤트 컨텍스트 GUID에 대한 포인터입니다. 이 메서드를 호출하면 아이콘 변경 이벤트가 생성되면 세션 관리자는 세션 관리자에 IAudioSessionEvents 인터페이스를 등록한 모든 클라이언트에 알림을 보냅니다. 세션 관리자에는 각 알림과 함께 EventContext 포인터 값이 포함됩니다. 알림을 받으면 클라이언트는 EventContext 값을 검사하여 해당 클라이언트 또는 다른 클라이언트가 이벤트의 원본인지 여부를 확인할 수 있습니다. 이 체계는 세션의 모든 클라이언트에서 고유한 이 매개 변수에 대한 값을 선택하는 클라이언트에 따라 달라집니다. 호출자가 이 매개 변수에 대한 NULL 포인터를 제공하는 경우 클라이언트의 알림 메서드는 NULL 컨텍스트 포인터를 받습니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.

반환 코드	설명
E_POINTER	매개 변수 값 은 NULL입니다.
AUDCLNT_E_DEVICE_INVALIDATED	오디오 엔드포인트 디바이스가 분리되었거나 오디오 하드웨어 또는 관련 하드웨어 리소스가 다시 구성, 비활성화, 제거 또는 사용할 수 없게 되었습니다.
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 오디오 서비스가 실행되고 있지 않습니다.

설명

Windows Vista에서 시스템 제공 프로그램인 Sndvol.exe 디스플레이 아이콘(표시 이름과 함께)을 사용하여 세션의 볼륨 컨트롤에 레이블을 지정합니다. 클라이언트가 SetIconPath 를 호출하여 세션에 아이콘을 할당하지 않으면 Sndvol 프로그램은 애플리케이션 창의 아이콘을 세션의 기본 아이콘으로 사용합니다.

교차 프로세스 세션의 경우 세션은 단일 애플리케이션 프로세스와 연결되지 않습니다. 따라서 Sndvol에는 기본적으로 사용할 애플리케이션별 아이콘이 없으며 클라이언트는 의미 없는 아이콘을 표시하지 않도록 SetIconPath 를 호출해야 합니다.

표시 아이콘은 IAudioSessionControl 개체의 수명 이후에도 유지되지 않습니다. 따라서 개체에 대한 모든 참조가 해제된 후에는 클라이언트가 SetIconPath를 호출할 때까지 개체의 이후에 만든 버전(동일한 애플리케이션, 동일한 세션 GUID 및 동일한 엔드포인트 디바이스 포함)이 다시 한 번 기본 아이콘이 됩니다.

클라이언트는 IAudioSessionControl::GetIconPath 메서드를 호출하여 세션의 표시 아이콘을 검색할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	audiopolicy.h

추가 정보

IAudioSessionControl 인터페이스

IAudioSessionControl::GetIconPath