次の方法で共有


KsPinGetConnectedPinInterface 関数 (ks.h)

KsPinGetConnectedPinInterface 関数は、COM スタイル インターフェイスの Pin が接続されているピンに対してクエリを実行します。

構文

KSDDKAPI NTSTATUS KsPinGetConnectedPinInterface(
  [in]  PKSPIN     Pin,
  [in]  const GUID *InterfaceId,
  [out] PVOID      *Interface
);

パラメーター

[in] Pin

KSPIN 構造体へのポインター。 AVStream は、 Pin に接続 されているピンに対して、要求されたインターフェイスのクエリを実行します。

[in] InterfaceId

取得するインターフェイスの種類を指定する GUID へのポインター。 QueryInterface 呼び出しは、このインターフェイスに対して自動的に実行されます。

[out] Interface

AVStream が COM インターフェイスの場所に設定するポインターへのポインター。

戻り値

KsPinGetConnectedPinInterface は、STATUS_SUCCESSまたはSTATUS_NOINTERFACEを返します。 詳細は以下を参照してください。

注釈

インターフェイス には対応する参照カウントがあり、COM のように呼び出し元によって解放される 必要があります

このルーチンは、接続されたピンまたは AVStream サンクにインターフェイスが存在する場合、STATUS_SUCCESSを返します。 STATUS_SUCCESSが返された場合、AVStream はインターフェイス ポインターを *Interface に設定します。 それ以外の場合、ルーチンはSTATUS_NOINTERFACEを返します。 これは COM HRESULT E_NOINTERFACEに対応します。

既定では、オブジェクトは IUnknown インターフェイスと IKsControl インターフェイスをサポートします。 接続されているピンが AVStream ピンの場合、クエリと返されるインターフェイス ポインターは、他のドライバーへの直接呼び出しです。 一方、接続されたピンが AVStream ドライバーに属していない場合は、IoCallDriver を使用して、接続されたピンを含むドライバーへの同期呼び出しを通じて IKsControl のサポートを提供するサンクが作成されます。

KsPinGetConnectedPinInterface の最も一般的な使用方法は、接続されたピンのコントロール インターフェイスを取得することです。 このコントロール インターフェイスは、接続されたピンに対するプロパティ、メソッド、またはイベント呼び出しに使用することも、接続されたピンに集計されたインターフェイスに対してクエリを実行することもできます。 接続されたピンが AVStream ピンの場合。AVStream では、非 AVStream ピンに対して IKsControlIUnknown に対してのみサンキングが提供されます。

サンクは、Pin がソース ピン の場合にのみ作成されます。したがって、呼び出しは、次の 1 つ以上が当てはまる場合にのみ機能します。

  • 接続は AVStream 内です (ピンの接続ピンは AVStream ピンです)。
  • Pin はソース ピンです。
それ以外の場合は、STATUS_UNSUCCESSFULが返されます。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetReferenceClockInterface

KsRegisterAggregatedClientUnknown