IKsJackDescription::GetJackCount メソッド (devicetopology.h)

GetJackCount メソッドは、オーディオ エンドポイント デバイスに接続するために必要なジャックの数を取得します。

構文

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

パラメーター

[out] pcJacks

メソッドがコネクタに関連付けられたジャックの数を書き込む UINT 変数へのポインター。

戻り値

メソッドが成功すると、S_OKが返されます。 失敗した場合、可能なリターン コードには、次の表に示す値が含まれますが、これらに限定されません。

リターン コード	形容
E_POINTER	pcJacks ポインターが NULL 。

備考

複数のチャネルを含むストリームを再生または記録するオーディオ エンドポイント デバイスでは、複数のジャック (物理コネクタ) との接続が必要になる場合があります。

たとえば、6 チャンネルのオーディオ ストリームを再生する一連のサラウンド スピーカーには、3 つのステレオ ジャックが必要な場合があります。 この例では、最初のジャックはフロント左右のスピーカーのチャネルを送信し、2 番目のジャックはフロントセンターおよび低周波数効果 (サブウーファー) スピーカーのチャネルを送信し、3 番目のジャックは左右のスピーカーのチャネルを送信します。

このメソッドを呼び出してジャック数を取得した後、ジャックごとに IKsJackDescription::GetJackDescription メソッドを 1 回呼び出して、ジャックの説明を取得します。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	devicetopology.h

関連項目

IKsJackDescription インターフェイス の

IKsJackDescription::GetJackDescription