다음을 통해 공유

IPart::GetSubType 메서드(devicetopology.h)

  • 아티클

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

구문

HRESULT GetSubType(
  [out] GUID *pSubType
);

매개 변수

[out] pSubType

메서드가 이 부분에 대한 하위 형식 GUID를 작성하는 GUID 변수에 대한 포인터입니다.

반환 값

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

반환 코드 설명
E_POINTER
 포인터 pSubType 이 NULL입니다.

설명

이 메서드는 일반적으로 헤더 파일 Ksmedia.h에서 KSNODETYPE_Xxx GUID 값 중 하나를 검색하지만 일부 사용자 지정 드라이버는 다른 GUID 값을 제공할 수 있습니다. KSNODETYPE_Xxx GUID에 대한 자세한 내용은 Windows DDK 설명서를 참조하세요.

IPart 인터페이스에 설명된 대로 파트는 커넥터 또는 하위 단위일 수 있습니다.

커넥터인 파트의 경우 이 메서드는 드라이버가 커넥터에 할당한 핀 범주 GUID를 검색합니다. 다음은 핀 범주 GUID의 예입니다.

  • 커넥터가 마이크 또는 스피커와 같은 아날로그 디바이스를 오가는 데이터 경로의 일부인 경우 KSNODETYPE_ANALOG_CONNECTOR.
  • 커넥터가 S/PDIF 포트를 오가는 데이터 경로의 일부인 경우 KSNODETYPE_SPDIF_INTERFACE.
자세한 내용은 Windows DDK 설명서에서 pin-category 속성 KSPROPERTY_PIN_CATEGORY 대한 설명을 참조하세요.

하위 단위인 파트의 경우 이 메서드는 하위 단위가 수행하는 스트림 처리 함수를 나타내는 하위 형식 GUID를 검색합니다. 예를 들어 볼륨 제어 하위 단위의 경우 메서드는 KSNODETYPE_VOLUME GUID 값을 검색합니다.

다음 표에서는 하위 단위에 대한 GetSubType 메서드에서 검색할 수 있는 하위 형식 GUID 중 일부를 나열합니다.

하위 형식 GUID 컨트롤 인터페이스 필수 또는 선택
KSNODETYPE_3D_EFFECTS IAudioChannelConfig 선택 사항
KSNODETYPE_AGC IAudioAutoGainControl 필수
KSNODETYPE_DAC IAudioChannelConfig 선택 사항
KSNODETYPE_DEMUX IAudioOutputSelector 필수
KSNODETYPE_DEV_SPECIFIC IDeviceSpecificProperty 필수
KSNODETYPE_LOUDNESS IAudioLoudness 필수
KSNODETYPE_MUTE IAudioMute 필수
KSNODETYPE_MUX IAudioInputSelector 필수
KSNODETYPE_PEAKMETER IAudioPeakMeter 필수
KSNODETYPE_PROLOGIC_DECODER IAudioChannelConfig 선택 사항
KSNODETYPE_TONE IAudioBass

IAudioMidrange

IAudioTreble

 OptionalOptional

선택 사항
KSNODETYPE_VOLUME IAudioChannelConfig

IAudioVolumeLevel

 OptionalRequired
 

앞의 표에서 가운데 열에는 왼쪽 열에 지정된 하위 형식의 하위 단위에서 지원하는 컨트롤 인터페이스가 나열됩니다. 오른쪽 열은 제어 인터페이스에 대한 하위 단위의 지원이 필요한지 아니면 선택 사항인지를 나타냅니다. 지원이 필요한 경우 애플리케이션은 지정된 하위 형식의 하위 단위를 사용하여 컨트롤 인터페이스를 지원할 수 있습니다. 지원이 선택 사항인 경우 지정된 하위 형식의 하위 단위는 컨트롤 인터페이스를 지원할 수 있지만 반드시 지원되는 것은 아닙니다.

앞의 테이블의 컨트롤 인터페이스는 하위 단위의 속성에 편리하게 액세스할 수 있도록 합니다. 그러나 일부 하위 단위에는 해당 컨트롤 인터페이스가 없는 속성이 있습니다. 애플리케이션은 IKsControl 인터페이스를 통해 이러한 속성에 액세스할 수 있습니다. 자세한 내용은 IKsControl 인터페이스를 사용하여 오디오 속성 액세스를 참조하세요.

요구 사항

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

추가 정보

IPart 인터페이스