KSJACK_DESCRIPTION 구조체(devicetopology.h)
KSJACK_DESCRIPTION 구조는 오디오 잭을 설명합니다.
구문
typedef struct __MIDL___MIDL_itf_devicetopology_0000_0000_0009 {
DWORD ChannelMapping;
COLORREF Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
멤버
ChannelMapping
스테레오 잭의 두 오디오 채널이 스피커 위치에 매핑되도록 지정합니다.
Windows Vista에서 이 멤버의 값은 다음 표에 표시된 EChannelMapping 열거형 값 중 하나입니다.
| 값 | 첫 번째 채널 | 두 번째 채널 |
|---|---|---|
| ePcxChanMap_FL_FR | 왼쪽 앞면 스피커 | 오른쪽 앞 스피커 |
| ePcxChanMap_FC_LFE | 프런트 센터 스피커 | 낮은 빈도 효과 스피커(서브우퍼) |
| ePcxChanMap_BL_BR | 왼쪽 뒤로 스피커 | 오른쪽 후면 스피커 |
| ePcxChanMap_FLC_FRC | 전면 왼쪽 가운데 스피커 | 전면 오른쪽 가운데 스피커 |
| ePcxChanMap_SL_SR | 왼쪽 옆면 스피커 | 오른쪽 스피커 |
| ePcxChanMap_Unknown | 알 수 없음 | 알 수 없음 |
Windows 7에서는 EChannelMapping 열거형이 더 이상 사용되지 않습니다. 이 멤버의 데이터 형식은 DWORD입니다. 이 멤버는 Ksmedia.h에 정의된 다음 값 중 하나 이상의 0 또는 비트 OR 조합을 저장합니다.
#define SPEAKER_FRONT_LEFT 0x1
#define SPEAKER_FRONT_RIGHT 0x2
#define SPEAKER_FRONT_CENTER 0x4
#define SPEAKER_LOW_FREQUENCY 0x8
#define SPEAKER_BACK_LEFT 0x10
#define SPEAKER_BACK_RIGHT 0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER 0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER 0x80
#define SPEAKER_BACK_CENTER 0x100
#define SPEAKER_SIDE_LEFT 0x200
#define SPEAKER_SIDE_RIGHT 0x400
#define SPEAKER_TOP_CENTER 0x800
#define SPEAKER_TOP_FRONT_LEFT 0x1000
#define SPEAKER_TOP_FRONT_CENTER 0x2000
#define SPEAKER_TOP_FRONT_RIGHT 0x4000
#define SPEAKER_TOP_BACK_LEFT 0x8000
#define SPEAKER_TOP_BACK_CENTER 0x10000
#define SPEAKER_TOP_BACK_RIGHT 0x20000
Color
잭 색입니다. 색은 8비트 파란색, 녹색 및 빨간색 구성 요소를 연결하여 형성되는 32비트 RGB 값으로 표현됩니다. 파란색 구성 요소는 가장 중요하지 않은 8비트(비트 0-7)를 차지하고, 녹색 구성 요소는 비트 8-15를 차지하고, 빨간색 구성 요소는 비트 16-23을 차지합니다. 8개의 가장 중요한 비트는 0입니다. 잭 색을 알 수 없거나 물리적 커넥터에 식별 가능한 색이 없는 경우 이 멤버의 값은 검은색인 0x00000000.
ConnectionType
연결 형식입니다. 이 멤버의 값은 다음 표에 표시된 EPcxConnectionType 열거형 값 중 하나입니다.
| 값 | 커넥터 유형 |
|---|---|
| eConnTypeUnknown | Unknown |
|
eConnTypeEighth(Windows Vista) eConnType3Point5mm (Windows 7) |
1/8인치 잭 |
| eConnTypeQuarter | 1/4인치 잭 |
| eConnTypeAtapiInternal | ATAPI 내부 커넥터 |
| eConnTypeRCA | RCA 잭 |
| eConnTypeOptical | 광학 커넥터 |
| eConnTypeOtherDigital | 일반 디지털 커넥터 |
| eConnTypeOtherAnalog | 제네릭 아날로그 커넥터 |
| eConnTypeMultichannelAnalogDIN | 다중 채널 아날로그 DIN 커넥터 |
| eConnTypeXlrProfessional | XLR 커넥터 |
| eConnTypeRJ11Modem | RJ11 모뎀 커넥터 |
| eConnTypeCombination | 커넥터 유형 조합 |
GeoLocation
잭의 기하학적 위치입니다. 이 멤버의 값은 다음 표에 표시된 EPcxGeoLocation 열거형 값 중 하나입니다.
| 값 | 기하학적 위치 |
|---|---|
| eGeoLocRear | 후면 탑재 패널 |
| eGeoLocFront | 전면 탑재 패널 |
| eGeoLocLeft | 왼쪽 탑재 패널 |
| eGeoLocRight | 오른쪽에 탑재된 패널 |
| eGeoLocTop | 위쪽에 탑재된 패널 |
| eGeoLocBottom | 아래쪽에 탑재된 패널 |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
뒤로 슬라이드 열기 또는 풀 열기 패널 |
| eGeoLocRiser | 라이저 카드 |
| eGeoLocInsideMobileLid | 모바일 컴퓨터의 내부 뚜껑 |
| eGeoLocDrivebay | 드라이브 베이 |
| eGeoLocHDMI | HDMI 커넥터 |
| eGeoLocOutsideMobileLid | 모바일 컴퓨터의 외부 덮개 |
| eGeoLocATAPI | ATAPI 커넥터 |
GenLocation
잭의 일반 위치입니다. 이 멤버의 값은 다음 표에 표시된 EPcxGenLocation 열거형 값 중 하나입니다.
| 값 | 일반 위치 |
|---|---|
| eGenLocPrimaryBox | 기본 섀시에서 |
| eGenLocInternal | 기본 섀시 내부 |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
별도의 섀시에서 |
| eGenLocOther | 기타 위치 |
PortConnection
잭이 나타내는 포트 유형입니다. 이 멤버의 값은 다음 표에 표시된 EPxcPortConnection 열거형 값 중 하나입니다.
| 값 | 포트 연결 유형 |
|---|---|
| ePortConnJack | 잭 |
| ePortConnIntegratedDevice | 통합 디바이스의 슬롯 |
| ePortConnBothIntegratedAndJack | 통합 디바이스에 대한 잭 및 슬롯 모두 |
| ePortConnUnknown | Unknown |
IsConnected
오디오 어댑터가 잭에서 잭 프레즌스 검색을 지원하는 경우 IsConnected 값은 엔드포인트 디바이스가 잭에 연결되어 있는지 여부를 나타냅니다. IsConnected가 TRUE이면 디바이스가 연결됩니다. FALSE이면 잭이 비어 있습니다. 잭 프레즌스 검색을 지원하지 않는 디바이스의 경우 이 멤버는 항상 TRUE입니다. 잭 프레즌스 검색에 대한 자세한 내용은 오디오 엔드포인트 디바이스를 참조하세요.
설명
이 구조체는 DeviceTopology API의 IKsJackDescription::GetJackDescription 메서드에서 사용됩니다. 엔드포인트 디바이스와 오디오 어댑터의 하드웨어 디바이스 간의 연결에 포함된 오디오 잭을 설명합니다. 사용자가 엔드포인트 디바이스를 잭에 연결하거나 잭에서 분리해야 하는 경우 오디오 애플리케이션은 구조의 설명 정보를 사용하여 사용자가 잭을 찾는 데 도움이 될 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | devicetopology.h |