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

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

構文

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

パラメーター

[out] pcJacks

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

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード	説明
E_POINTER	ポインター pcJacks は NULL です。

注釈

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

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

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	devicetopology.h

こちらもご覧ください

IKsJackDescription インターフェイス

IKsJackDescription::GetJackDescription