오디오 드라이버 속성 집합

이 섹션에서는 Microsoft Windows 2000 이상 및 Windows Millennium Edition(Me) 및 Windows 98에서 WDM 커널 스트리밍 서비스를 사용하는 오디오 드라이버에 사용할 수 있는 오디오 관련 속성 집합에 대해 설명합니다.

각 속성에 대한 참조 페이지에는 다음 열 머리글이 있는 테이블이 포함되어 있습니다.

Get Set 대상 속성 설명자 형식 속성 값 형식

이러한 제목에는 다음과 같은 의미가 있습니다.

  • 가져오기

    대상 KS 개체가 KSPROPERTY_TYPE_GET 속성 요청을 지원하나요? (예 또는 아니요를 지정합니다.)

  • 설정

    대상 KS 개체가 KSPROPERTY_TYPE_SET 속성 요청을 지원하나요? (예 또는 아니요를 지정합니다.)

  • 대상

    요청의 대상은 속성 요청이 전송되는 KS 개체입니다. 오디오 속성의 대상은 필터 또는 핀입니다. (속성 요청은 해당 커널 핸들로 대상 개체를 지정합니다.)

  • 속성 설명자 형식

    속성 설명자는 해당 속성에 대해 수행할 속성과 작업을 지정합니다. 설명자는 항상 KSPROPERTY 구조로 시작하지만 일부 형식의 설명자에는 추가 정보가 포함되어 있습니다. 예를 들어 KSNODEPROPERTY 구조체는 KSPROPERTY 구조체로 시작하지만 노드 ID도 포함하는 속성 설명자입니다.

  • 속성 값 형식

    속성에는 일반적으로 값이 있으며 이 값의 형식은 속성에 따라 달라집니다. 예를 들어 온 또는 오프 상태 중 하나에 있을 수 있는 속성에는 일반적으로 BOOL 값이 있습니다. 정수 값을 0에서 0xFFFFFFFF 가정할 수 있는 속성에는 ULONG 값이 있을 수 있습니다. 더 복잡한 속성에는 배열 또는 구조체인 값이 있을 수 있습니다.

앞의 속성 설명자 및 속성 값은 KS 속성, 이벤트 및 메서드에서 설명하는 instance 사양 및 operation-data 버퍼의 속성별 버전입니다.

속성 요청은 다음 플래그 중 하나를 사용하여 속성에서 수행할 작업을 지정합니다.

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

모든 필터 및 핀 개체는 해당 속성에 대한 기본 지원 작업을 지원합니다. 가져오기 및 설정 작업을 지원하는지 여부는 속성에 따라 달라집니다. 필터 또는 핀 개체의 고유 기능을 나타내는 속성은 가져오기 작업만 필요할 수 있습니다. 구성 가능한 설정을 나타내는 속성에는 설정 작업만 필요할 수 있지만 get 작업은 현재 설정을 읽는 데 유용할 수도 있습니다. 오디오 속성과 함께 get, set 및 basic-support 작업을 사용하는 방법에 대한 자세한 내용은 오디오 엔드포인트, 속성 및 이벤트를 참조하세요.

오디오 드라이버에 대해 정의된 속성 집합은 다음과 같습니다.

KSPROPSETID_AC3

KSPROPSETID_Acoustic_Echo_Cancel

KSPROPSETID_Audio

KSPROPSETID_AudioEngine

KSPROPSETID_AudioGfx

KSPROPSETID_AudioLoopback

KSPROPSETID_AudioModule

KSPROPSETID_BtAudioModule

KSPROPSETID_DirectSound3DBuffer

KSPROPSETID_DirectSound3DListener

KSPROPSETID_DrmAudioStream

KSPROPSETID_FMRXControl

KSPROPSETID_FMRXTopology

KSPROPSETID_Hrtf3d

KSPROPSETID_Itd3d

KSPROPSETID_Jack

KSPROPSETID_RTAudio

KSPROPSETID_SoundDetector

KSPROPSETID_SoundDetector2

KSPROPSETID_Synth

KSPROPSETID_SynthClock

KSPROPSETID_Synth_Dls

KSPROPSETID_Sysaudio

KSPROPSETID_Sysaudio_Pin

KSPROPSETID_TelephonyControl

KSPROPSETID_TelephonyTopology

KSPROPSETID_TopologyNode