IKsJackDescription：：GetJackDescription 方法（devicetopology.h）

GetJackDescription 方法會取得音訊插孔的描述。

語法

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

[in] nJack

插孔索引。如果連線是由 n 個插孔所組成，則會將插孔編號為 0 到 n n– 1。若要取得插孔數目，請呼叫 IKsJackDescription：：GetJackCount 方法。

[out] pDescription

呼叫端配置的緩衝區指標，方法會寫入類型為 KSJACK_DESCRIPTION 結構，其中包含插孔的相關信息。緩衝區大小至少必須是sizeof（KSJACK_DESCRIPTION）。

如果方法成功，則會傳回S_OK。如果失敗，可能的傳回碼會包含，但不限於下表中顯示的值。

傳回碼	描述
E_INVALIDARG	參數 nJack 不是有效的插孔索引。
E_POINTER	pDescription 指標NULL。

當使用者需要將音訊端點裝置插入插孔或從插孔中拔除時，音訊應用程式可以使用從此方法擷取的描述性資訊，協助使用者尋找插孔。此資訊包括：

如需詳細資訊，請參閱 KSJACK_DESCRIPTION。