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 |