IAudioOutputSelector::SetSelection 메서드(devicetopology.h)

SetSelection 메서드는 출력 선택기의 출력 중 하나를 선택합니다.

구문

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

매개 변수

[in] nIdSelect

새 선택기 출력입니다. 호출자는 이 매개 변수를 선택기 출력 중 하나에 대한 직접 링크가 있는 파트의 로컬 ID로 설정해야 합니다.

[in] pguidEventContext

IControlChangeNotify::OnNotify 메서드의 컨텍스트 값입니다. 이 매개 변수는 이벤트 컨텍스트 GUID를 가리킵니다. SetSelection 호출이 출력 선택기 컨트롤의 상태를 변경하면 해당 컨트롤에 IControlChangeNotify 인터페이스를 등록한 모든 클라이언트가 알림을 받습니다. OnNotify 메서드의 구현에서 클라이언트는 이벤트 컨텍스트 GUID를 검사하여 이벤트 또는 다른 클라이언트가 제어-변경 이벤트의 원본인지 여부를 검색할 수 있습니다. 호출자가 이 매개 변수에 대한 NULL 포인터를 제공하는 경우 클라이언트의 알림 메서드는 NULL 컨텍스트 포인터를 받습니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
매개 변수 nIdSelect 는 선택기 출력에 있는 파트의 로컬 ID가 아닙니다.
E_OUTOFMEMORY
메모리가 부족합니다.

설명

로컬 ID는 디바이스 토폴로지의 모든 부분 중 일부를 고유하게 식별하는 숫자입니다. 파트의 로컬 ID를 가져오려면 파트 개체에서 IPart::GetLocalId 메서드를 호출합니다.

요구 사항

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

추가 정보

IAudioOutputSelector 인터페이스

IPart::GetLocalId