다음을 통해 공유


IKsJackDescription::GetJackDescription 메서드(devicetopology.h)

GetJackDescription 메서드는 오디오 잭에 대한 설명을 가져옵니다.

구문

HRESULT GetJackDescription(
  [in]  UINT               nJack,
  [out] KSJACK_DESCRIPTION *pDescription
);

매개 변수

[in] nJack

잭 인덱스입니다. 연결이 n 잭으로 구성된 경우 잭의 번호는 0에서 n– 1로 지정됩니다. 잭 수를 얻으려면 IKsJackDescription::GetJackCount 메서드를 호출합니다.

[out] pDescription

메서드가 잭에 대한 정보를 포함하는 형식 KSJACK_DESCRIPTION 구조를 작성하는 호출자 할당 버퍼에 대한 포인터입니다. 버퍼 크기는 적어도 sizeof(KSJACK_DESCRIPTION)여야 합니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 코드 설명
E_INVALIDARG
매개 변수 nJack 이 유효한 잭 인덱스가 아닙니다.
E_POINTER
포인터 pDescriptionNULL입니다.

설명

사용자가 오디오 엔드포인트 디바이스를 잭에 연결하거나 잭에서 분리해야 하는 경우 오디오 애플리케이션은 이 메서드에서 검색하는 설명 정보를 사용하여 사용자가 잭을 찾을 수 있도록 도울 수 있습니다. 여기에는 다음 정보가 포함됩니다.

  • 컴퓨터 섀시 또는 외부 상자에서 잭의 실제 위치입니다.
  • 잭의 색입니다.
  • 잭에 사용되는 물리적 커넥터의 유형입니다.
  • 잭에 대한 채널 매핑입니다.
자세한 내용은 KSJACK_DESCRIPTION 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 devicetopology.h

추가 정보

IKsJackDescription 인터페이스

IKsJackDescription::GetJackCount

KSJACK_DESCRIPTION