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	포인터 pDescription 이 NULL입니다.

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

자세한 내용은 KSJACK_DESCRIPTION 참조하세요.