오디오 엔드포인트 속성
헤더 파일 Mmdeviceapi.h는 Windows Vista 이상에서 오디오 엔드포인트 디바이스 의 여러 속성을 정의합니다. Windows 오디오 서비스는 이러한 속성의 값을 설정합니다. 클라이언트는 이러한 속성을 읽을 수 있지만 설정하면 안 됩니다. 속성 값은 PROPVARIANT 구조체로 저장됩니다.
오디오 입력 디바이스의 속성을 읽는 권장 방법은 Windows.Devices.Enumeration 네임스페이스의 API를 사용하는 것입니다. 이러한 API는 Windows 스토어 앱 및 데스크톱 앱에서 지원됩니다. IMMDevice 인터페이스를 사용하여 디바이스 속성을 읽는 기존 데스크톱 앱은 디바이스 속성을 참조하세요. IMMDevice 는 Windows 스토어 앱에서 지원되지 않습니다.
오디오 엔드포인트 디바이스의 속성에 액세스하는 방법을 보여 주는 코드 예제는 다음 topics 참조하세요.
PROPVARIANT에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.
다음 속성은 오디오 엔드포인트 디바이스와 관련이 있습니다.
| 속성 | Description |
|---|---|
| PKEY_AudioEndpoint_Association | KS(커널 스트리밍) 핀 범주를 오디오 엔드포인트 디바이스와 연결합니다. |
| PKEY_AudioEndpoint_ControlPanelPageProvider | 오디오 엔드포인트 디바이스에 대한 디바이스 속성 확장의 등록된 공급자 CLSID를 지정합니다. |
| PKEY_AudioEndpoint_Disable_SysFx | 오디오 엔드포인트 디바이스를 오가는 공유 모드 스트림에서 시스템 효과를 사용할 수 있는지 여부를 나타냅니다. |
| PKEY_AudioEndpoint_FormFactor | 오디오 엔드포인트 디바이스의 물리적 특성을 나타냅니다. |
| PKEY_AudioEndpoint_FullRangeSpeakers | 오디오 엔드포인트 디바이스에 연결된 전체 범위 스피커의 채널 구성 마스크를 지정합니다. |
| PKEY_AudioEndpoint_GUID | 오디오 엔드포인트 디바이스에 해당하는 DirectSound 디바이스 식별자를 제공합니다. |
| PKEY_AudioEndpoint_PhysicalSpeakers | 오디오 엔드포인트 디바이스에 대한 실제 스피커 구성을 정의합니다. |
| PKEY_AudioEngine_DeviceFormat | 오디오 엔진이 오디오 엔드포인트 디바이스를 오가는 공유 모드 스트림에 사용하는 형식인 디바이스 형식을 지정합니다. |
| PKEY_AudioEngine_OEMFormat | 스트림을 렌더링하거나 캡처하는 데 사용되는 디바이스의 기본 형식을 지정합니다. 값은 .inf 파일의 OEM에 의해 채워집니다. |
| PKEY_AudioEndpoint_Supports_EventDriven_Mode | 엔드포인트가 이벤트 기반 모드를 지원하는지 여부를 나타냅니다. 값은 .inf 파일의 OEM에 의해 채워집니다. |
| PKEY_AudioEndpoint_JackSubType | 오디오 엔드포인트 디바이스에 대한 출력 범주 GUID를 포함합니다. |
핵심 오디오 API는 오디오 엔드포인트 디바이스에만 적용되지 않는 추가 속성을 지원합니다. 이러한 추가 속성에 대한 자세한 내용은 디바이스 속성을 참조하세요.