IPart 인터페이스(devicetopology.h)

  • 아티클

IPart 인터페이스는 디바이스 토폴로지의 파트(커넥터 또는 하위 단위)를 나타냅니다. 클라이언트는 IDeviceTopology::GetPartById 또는 IPartsList::GetPart 메서드를 호출하거나 파트 개체에서 IConnector 또는 ISubunit 인터페이스의 QueryInterface 메서드를 호출하고 메서드의 iid 매개 변수를 REFIID IID_IPart 설정하여 IPart 인터페이스에 대한 참조를 가져옵니다.

IPart 인터페이스가 있는 개체는 다음 디바이스 토폴로지 부분 중 하나를 캡슐화할 수 있습니다.

  • 커넥터. 이는 다른 디바이스에 연결하여 디바이스 간에 오디오 스트림을 전송하기 위한 데이터 경로를 형성하는 부분입니다.
  • Subunit. 오디오 스트림(예: 볼륨 제어)을 처리하는 부분입니다.
커넥터 또는 하위 단위 개체의 IPart 인터페이스는 모든 파트에 공통적인 제네릭 함수를 나타내며 개체의 IConnector 또는 ISubunit 인터페이스는 커넥터 또는 하위 단위와 관련된 함수를 나타냅니다. 또한 파트는 파트의 기능을 제어하거나 모니터링하기 위해 하나 이상의 제어 인터페이스를 지원할 수 있습니다. 예를 들어 클라이언트는 IAudioVolumeLevel 인터페이스를 통해 볼륨 제어 하위 단위를 제어합니다.

IPart 인터페이스는 커넥터 또는 하위 단위의 이름, 로컬 ID, 전역 ID 및 일부 형식을 가져오는 메서드를 제공합니다. 또한 IPart 는 커넥터 또는 하위 단위에서 컨트롤 인터페이스를 활성화할 수 있습니다.

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

상속

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

메서드

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

 
IPart::Activate

Activate 메서드는 커넥터 또는 하위 단위에서 함수별 인터페이스를 활성화합니다.
IPart::EnumPartsIncoming

EnumPartsIncoming 메서드는 들어오는 모든 부분, 즉 이 부분에서 업스트림 데이터 경로에 있는 파트의 목록을 가져옵니다.
IPart::EnumPartsOutgoing

EnumPartsOutgoing 메서드는 이 부분의 다운스트림에 있는 데이터 경로에 있는 모든 나가는 부분의 목록을 검색합니다.
IPart::GetControlInterface

GetControlInterface 메서드는 이 부분이 지원하는 경우 지정된 컨트롤 인터페이스에 대한 참조를 가져옵니다.
IPart::GetControlInterfaceCount

GetControlInterfaceCount 메서드는 이 파트에서 지원하는 컨트롤 인터페이스 수를 가져옵니다.
IPart::GetGlobalId

GetGlobalId 메서드는 이 파트의 전역 ID를 가져옵니다.
IPart::GetLocalId

GetLocalId 메서드는 이 파트의 로컬 ID를 가져옵니다.
IPart::GetName

GetName 메서드는 이 파트의 이름을 가져옵니다.
IPart::GetPartType

GetPartType 메서드는 이 파트의 파트 형식을 가져옵니다.
IPart::GetSubType

GetSubType 메서드는 이 파트의 파트 하위 형식을 가져옵니다.
IPart::GetTopologyObject

GetTopologyObject 메서드는 이 부분을 포함하는 디바이스 토폴로지 개체의 IDeviceTopology 인터페이스에 대한 참조를 가져옵니다.
IPart::RegisterControlChangeCallback

RegisterControlChangeCallback 메서드는 IControlChangeNotify 인터페이스를 등록합니다. 이 인터페이스는 클라이언트가 이 부분에서 상태 변경 내용에 대한 알림을 수신하기 위해 구현합니다.
IPart::UnregisterControlChangeCallback

UnregisterControlChangeCallback 메서드는 IPart::RegisterControlChangeCallback 메서드를 호출하여 클라이언트가 이전에 등록한 IControlChangeNotify 인터페이스의 등록을 제거합니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

DeviceTopology API

IAudioVolumeLevel 인터페이스

IConnector 인터페이스

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit 인터페이스