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 | SPEAKER_FRONT_RIGHT) 헤더 파일 Ksmedia.h에 정의되어 있습니다. ChannelMapping 은 아날로그 렌더링 핀에 대해서만 0이 아니어야 합니다. 캡처 핀 또는 디지털 렌더링 핀의 경우 이 멤버를 0으로 설정합니다.
참고
Devicetopology.h는 원래 ChannelMapping 을 EChannelMapping 형식의 열거형으로 정의했습니다. 이후 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 포함) |