events
IKsJackDescription2 インターフェイス (devicetopology.h)
IKsJackDescription2 インターフェイスは、オーディオ アダプター上のデバイスと外部または内部のエンドポイント デバイス (マイクや CD プレーヤーなど) との間の物理的な接続を提供するジャックまたは内部コネクタに関する情報を提供します。
IKsJackDescription は、接続の種類などのジャック情報を取得するだけでなく、主にジャックがデバイスに接続されたかどうかを報告するために使用されます。 Windows 7 では、接続されているデバイス ドライバーが IKsJackDescription2 をサポートしている場合、オーディオ スタックまたはアプリケーションはこのインターフェイスを使用して追加情報のジャック情報を取得できます。 これには、ジャックの検出機能と、デバイスの形式が動的に変更された場合が含まれます。
ほとんどの Windows オーディオ アダプター ドライバーは、Windows ドライバー モデル (WDM) をサポートし、カーネル ストリーミング (KS) プロパティを使用して、コネクタ (KS ピンと呼ばれます) のハードウェア記述パラメーターを表します。 IKsJackDescription2 インターフェイスを使用すると、エンドポイント デバイスへのコネクタの KSPROPERTY_JACK_DESCRIPTION2 プロパティに簡単にアクセスできます。 KS プロパティと KS ピンの詳細については、Windows DDK のドキュメントを参照してください。
アプリケーションは、パラメーター refiid が REFIIDIID_IKsJackDescription2に設定された IPart::Activate メソッドを呼び出すことによって、パーツの IKsJackDescription2 インターフェイスへの参照を取得します。 IPart::Activate の呼び出しは、パーツが IKsJackDescription2 インターフェイスをサポートしている場合にのみ成功します。 KS フィルター デバイス トポロジ オブジェクトのブリッジ ピン コネクタを表すパーツ オブジェクトのみが、このインターフェイスをサポートします。
コード例については、「 IKsJackDescription」を参照してください。
IKsJackDescription2 インターフェイスは、IUnknown インターフェイスから継承します。 IKsJackDescription2 には、次の種類のメンバーもあります。
IKsJackDescription2 インターフェイスには、これらのメソッドがあります。
IKsJackDescription2::GetJackCount GetJackCount メソッドは、エンドポイント デバイスに接続するために必要なコネクタのジャックの数を取得します。 |
IKsJackDescription2::GetJackDescription2 GetJackDescription2 メソッドは、指定されたオーディオ ジャックの説明を取得します。 |
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | devicetopology.h |