다음을 통해 공유


IDeviceTopology 인터페이스(devicetopology.h)

IDeviceTopology 인터페이스는 오디오 디바이스의 토폴로지 액세스 권한을 제공합니다. 오디오 어댑터 디바이스의 토폴로지 는 오디오 엔드포인트 디바이스로 이어지는 데이터 경로와 경로를 따라 놓는 제어 지점으로 구성됩니다. 오디오 엔드포인트 디바이스에는 토폴로지도 있지만 디바이스 토폴로지에서 설명한 대로 간단합니다. 클라이언트는 다음 단계에 따라 오디오 엔드포인트 디바이스에 대한 IDeviceTopology 인터페이스에 대한 참조를 가져옵니다.

  1. IMMDevice 인터페이스에 설명된 기술 중 하나를 사용하여 오디오 엔드포인트 디바이스에 대한 IMMDevice 인터페이스에 대한 참조를 가져옵니다.
  2. refiid 매개 변수가 REFIID IID_IDeviceTopology 설정된 IMMDevice::Activate 메서드를 호출합니다.
오디오 엔드포인트 디바이스에 대한 IDeviceTopology 인터페이스를 가져온 후 애플리케이션은 엔드포인트 디바이스가 연결된 오디오 어댑터 디바이스의 토폴로지를 탐색할 수 있습니다.

IDeviceTopology 인터페이스를 사용하는 코드 예제는 디바이스 토폴로지에서 GetHardwareDeviceTopology 및 SelectCaptureDevice 함수의 구현을 참조하세요.

상속

IDeviceTopology 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDeviceTopology 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IDeviceTopology 인터페이스에는 이러한 메서드가 있습니다.

 
IDeviceTopology::GetConnector

GetConnector 메서드는 커넥터 번호로 지정된 커넥터를 가져옵니다.
IDeviceTopology::GetConnectorCount

GetConnectorCount 메서드는 디바이스 토폴로지 개체의 커넥터 수를 가져옵니다.
IDeviceTopology::GetDeviceId

GetDeviceId 메서드는 디바이스 토폴로지 개체로 표시되는 디바이스의 디바이스 식별자를 가져옵니다.
IDeviceTopology::GetPartById

GetPartById 메서드는 로컬 ID로 식별되는 파트를 가져옵니다.
IDeviceTopology::GetSignalPath

GetSignalPath 메서드는 경로가 있는 경우 두 부분을 연결하는 신호 경로의 파트 목록을 가져옵니다.
IDeviceTopology::GetSubunit

GetSubunit 메서드는 하위 단위 번호로 지정된 하위 단위를 가져옵니다.
IDeviceTopology::GetSubunitCount

GetSubunitCount 메서드는 디바이스 토폴로지의 하위 단위 수를 가져옵니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

DeviceTopology API

IMMDevice::Activate