KsPinGetConnectedPinInterface 関数 (ks.h)

[アーティクル]
03/05/2024

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 ピンに対して IKsControl と IUnknown に対してのみサンキングが提供されます。

サンクは、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