KSJACK_DESCRIPTION 구조체
KSJACK_DESCRIPTION 구조체는 오디오 잭의 물리적 특성을 지정합니다.
구문
typedef struct {
DWORD ChannelMapping;
DWORD Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
구성원
ChannelMapping
오디오 채널의 해당 스피커 위치에 대한 매핑을 지정합니다. ChannelMapping 은 KSAUDIO_SPEAKER_XXX 플래그의 비트 마스크입니다(예: SPEAKER_FRONT_LEFT | 헤더 파일 Ksmedia.h에 정의된 SPEAKER_FRONT_RIGHT)입니다. ChannelMapping 은 아날로그 렌더링 핀에 대해서만 0이 아니어야 합니다. 캡처 핀 또는 디지털 렌더링 핀의 경우 이 멤버를 0으로 설정합니다.
참고
Devicetopology.h는 원래 EChannelMapping 형식의 열거형으로 ChannelMapping을 정의했습니다. EChannelMapping 열거형은 이후 사용되지 않으며 Windows Vista 이상 버전의 Windows 운영 체제에서 더 이상 사용되지 않습니다.
색상
잭 색을 지정합니다. 색은 8비트 파란색, 녹색 및 빨간색 구성 요소를 연결하여 형성되는 32비트 RGB 값으로 표현됩니다. 파란색 구성 요소는 8개의 가장 중요한 비트(비트 0-7)를 차지하고, 녹색 구성 요소는 비트 8-15를 차지하고, 빨간색 구성 요소는 비트 16-23을 차지합니다. 가장 중요한 8개 비트는 0입니다. 잭 색을 알 수 없거나 실제 연결선에 식별 가능한 색이 없는 경우 이 멤버의 값은 검은색을 나타내는 0x00000000.
ConnectionType
이 잭의 실제 연결 유형을 지정합니다. 이 멤버의 값은 다음 표에 표시된 EPcxConnectionType 열거형 값 중 하나입니다.
| 값 | 커넥터 유형 |
|---|---|
eConnTypeUnknown |
Unknown |
eConnType3Point5mm |
3.5mm 미니잭 |
eConnTypeQuarter |
1/4인치 잭 |
eConnTypeAtapiInternal |
ATAPI 내부 커넥터 |
eConnTypeRCA |
RCA 잭 |
eConnTypeOptical |
광학 커넥터 |
eConnTypeOtherDigital |
일반 디지털 커넥터 |
eConnTypeOtherAnalog |
제네릭 아날로그 커넥터 |
eConnTypeMultichannelAnalogDIN |
다중 채널 아날로그 DIN 커넥터 |
eConnTypeXlrProfessional |
XLR 커넥터 |
eConnTypeRJ11Modem |
RJ11 모뎀 커넥터 |
eConnTypeCombination |
커넥터 조합 |
Geolocation
잭의 기하학적 위치입니다. 이 멤버의 값은 다음 표에 표시된 EPcxGeoLocation 열거형 값 중 하나입니다.
| 값 | 기하학적 위치 |
|---|---|
eGeoLocRear |
Rear |
eGeoLocFront |
Front |
eGeoLocLeft |
왼쪽 |
eGeoLocRight |
오른쪽 |
eGeoLocTop |
상위 |
eGeoLocBottom |
아래쪽 |
eGeoLocRearPanel |
뒤로 슬라이드 열기 또는 풀 열기 패널 |
eGeoLocRiser |
라이저 카드 |
eGeoLocInsideMobileLid |
모바일 컴퓨터의 내부 뚜껑 |
eGeoLocDrivebay |
드라이브 베이 |
eGeoLocHDMI |
HDMI 커넥터 |
eGeoLocOutsideMobileLid |
모바일 컴퓨터의 외부 뚜껑 |
eGeoLocATAPI |
ATAPI 커넥터 |
eGeoLocNotApplicable |
해당 사항 없음 주의 섹션을 참조하세요. |
GenLocation
잭의 일반 위치를 지정합니다. 이 멤버의 값은 다음 표에 표시된 EPcxGenLocation 열거형 값 중 하나입니다.
| 값 | 일반 위치 |
|---|---|
eGenLocPrimaryBox |
기본 섀시 |
eGenLocInternal |
기본 섀시 내부 |
eGenLocSeparate |
별도의 섀시에서 |
eGenLocOther |
기타 위치 |
PortConnection
잭이 나타내는 포트의 유형을 지정합니다. 이 멤버의 값은 다음 표에 표시된 EPxcPortConnection 열거형 값 중 하나입니다.
| 값 | 포트 연결 유형 |
|---|---|
ePortConnJack |
잭 |
ePortConnIntegratedDevice |
통합 디바이스의 슬롯 |
ePortConnBothIntegratedAndJack |
통합 디바이스에 대한 잭 및 슬롯 |
ePortConnUnknown |
Unknown |
IsConnected
잭에 연결된 외부 디바이스가 있는지 여부를 나타냅니다. 오디오 컨트롤러가 이 핀에서 잭 검색을 지원하는 경우 IsConnected 값은 지정된 시간에 잭이 플러그에 의해 점유되는지 여부를 정확하게 나타내야 합니다. 잭 검색을 지원하지 않는 디바이스의 경우 이 값을 항상 TRUE 로 설정해야 합니다.
설명
이 구조는 Windows Vista 이상에서 KSPROPERTY_JACK_DESCRIPTION 속성에서 사용됩니다. 엔드포인트 디바이스와 오디오 어댑터의 하드웨어 디바이스 간의 연결에 포함된 오디오 잭에 대해 설명합니다. 사용자가 엔드포인트 디바이스를 잭에 연결하거나 잭에서 분리해야 하는 경우 오디오 애플리케이션은 구조의 설명 정보를 사용하여 사용자가 잭을 찾는 데 도움이 될 수 있습니다.
오디오 디바이스가 물리적으로 액세스할 수 있는 잭을 노출하지 않는 경우 오디오 디바이스는 eGeoLocNotApplicable 값을 사용하여 물리적 잭이 없음을 Windows 및 Windows 기반 앱을 나타냅니다. 따라서 기하학적 위치도 없습니다. 예를 들어 오디오 디바이스는 액세스 가능한 잭 없이 마더보드에 통합할 수 있습니다.
요구 사항
헤더 |
Ksmedia.h(Ksmedia.h 포함) |