다음을 통해 공유

ACX_JACK_DESCRIPTION 구조체(acxpin.h)

  • 아티클

ACX_JACK_DESCRIPTION 구조는 연결 유형, 물리적 위치 등 오디오 잭의 특성을 설명합니다.

구문

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

멤버

ChannelMapping

오디오 채널이 해당 스피커 위치에 매핑되도록 지정합니다. ChannelMapping 은 KSAUDIO_SPEAKER_XXX 플래그의 비트 마스크입니다(예: SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT) 헤더 파일 Ksmedia.h에 정의되어 있습니다. ChannelMapping 은 아날로그 렌더링 핀에 대해서만 0이 아니어야 합니다. 캡처 핀 또는 디지털 렌더링 핀의 경우 이 멤버를 0으로 설정합니다.

Color

잭 색을 지정합니다. 색은 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

설명

이 구조는 엔드포인트 디바이스와 오디오 어댑터의 하드웨어 디바이스 간의 연결에 포함된 오디오 잭을 설명합니다. 사용자가 엔드포인트 디바이스를 잭에 연결하거나 잭에서 분리해야 하는 경우 오디오 애플리케이션은 구조의 설명 정보를 사용하여 사용자가 잭을 찾을 수 있도록 도울 수 있습니다.

오디오 디바이스가 물리적으로 액세스할 수 있는 잭을 노출하지 않는 경우 오디오 디바이스는 eGeoLocNotApplicable 값을 사용하여 Windows 및 Windows 기반 앱에 물리적 잭이 없음을 나타냅니다. 따라서 기하학적 위치도 없습니다. 예를 들어 오디오 디바이스는 액세스 가능한 잭 없이 마더보드에 통합할 수 있습니다.

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항 값
헤더 acxpin.h

추가 정보