ICaptureGraphBuilder2::FindPin メソッド (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは FindPin 、フィルターの特定のピンを取得するか、指定したピンが指定した条件と一致するかどうかを判断します。

構文

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

パラメーター

[in] pSource

フィルター上のインターフェイスへのポインター、またはピン上のインターフェイスへのポインター。

[in] pindir

ピンの方向 (入力または出力) を指定する PIN_DIRECTION 列挙体のメンバー。

[in] pCategory

Pin プロパティ セットに一覧表示されているピン カテゴリのいずれかを指定する GUID へのポインター。 カテゴリに関係なく、任意のピンと一致するには、このパラメーターを NULL に設定 します。

[in] pType

メディアの種類を指定するメジャー型 GUID へのポインター。 任意のメディアの種類を照合するには 、NULL を 使用します。

[in] fUnconnected

ピンを接続解除する必要があるかどうかを示すブール値。 TRUE の場合、ピンは接続されていない必要があります。 FALSE の場合、ピンは接続または接続解除できます。

[in] num

一致するピンのセットから取得するピンの 0 から始まるインデックス。 pSource がフィルターへのポインターであり、複数のピンが検索条件と一致する場合、このパラメーターは取得するピンを指定します。 pSource がピンへのポインターである場合、このパラメーターは無視されます。

[out] ppPin

一致するピンの IPin インターフェイスを受け取るポインターのアドレス。

戻り値

一致するピンが見つかった場合はS_OKを返し、それ以外の場合はE_FAIL返します。

解説

pSource がフィルターへのポインターである場合、メソッドは検索条件に一致する n 番目のピンを検索します。ここで、n は num パラメーターによって指定されます。 メソッドは、一致するピンを見つけた場合、 ppPin パラメーター内のピンへのポインターを返します。

pSource がピンへのポインターである場合、メソッドは検索条件に対してピン留めをテストします。 ピンが条件と一致する場合、メソッドは S_OKを返し、ppPin パラメーターでピンの IPin インターフェイスへのポインターを返します。 それ以外の場合は、E_FAILを返します。

どちらの場合も、メソッドが成功した場合、 ppPin パラメーターで返される IPin インターフェイスには未処理の参照カウントがあります。 インターフェイスの使用が完了したら、必ずインターフェイスを解放してください。

通常、アプリケーションはこのメソッドを使用する必要はありません。 これは、ICaptureGraphBuilder2::RenderStream メソッドがフィルター グラフを作成できない場合に、非常に複雑なタスクに対して提供されます。 キャプチャ フィルターから目的のピンを取得し、グラフの残りの部分を手動で作成するには、このメソッドを使用します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

関連項目

エラーコードと成功コード

ICaptureGraphBuilder2 インターフェイス