다음을 통해 공유

IMMNotificationClient::OnPropertyValueChanged 메서드(mmdeviceapi.h)

  • 아티클

OnPropertyValueChanged 메서드는 오디오 엔드포인트 디바이스에 속하는 속성의 값이 변경되었음을 나타냅니다.

구문

HRESULT OnPropertyValueChanged(
  [in] LPCWSTR           pwstrDeviceId,
  [in] const PROPERTYKEY key
);

매개 변수

[in] pwstrDeviceId

오디오 엔드포인트 디바이스를 식별하는 엔드포인트 ID 문자열 에 대한 포인터입니다. 이 매개 변수는 엔드포인트 ID를 포함하는 null로 끝나는 와이드 문자열을 가리킵니다. 문자열은 호출 기간 동안 유효한 상태로 유지됩니다.

[in] key

속성을 지정하는 PROPERTYKEY 구조체입니다. 구조체에는 속성 집합 GUID와 집합 내의 속성을 식별하는 인덱스가 포함됩니다. 구조체는 값으로 전달됩니다. 호출 기간 동안 유효한 상태로 유지됩니다. PROPERTYKEY에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

반환 값

메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.

설명

오디오 엔드포인트 디바이스의 속성 값을 성공적으로 변경하는 IPropertyStore::SetValue 메서드를 호출하면 OnPropertyValueChanged에 대한 호출이 생성됩니다. IPropertyStore::SetValue에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

클라이언트는 키 매개 변수를 사용하여 새 속성 값을 검색할 수 있습니다. 속성 키를 사용하여 엔드포인트 디바이스의 속성 저장소에서 속성 값을 검색하는 코드 예제는 디바이스 속성을 참조하세요.

OnPropertyValueChanged 메서드를 구현하는 코드 예제는 디바이스 이벤트를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mmdeviceapi.h

추가 정보

IMMNotificationClient 인터페이스