IPin インターフェイス (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
このインターフェイスは、すべての入力ピンと出力ピンによって公開されます。
フィルター グラフ マネージャーは、このインターフェイスを使用してピンを接続し、フラッシュ操作を実行します。 アプリケーションでは、このインターフェイスを使用して、ピンに情報のクエリを実行できます。 アプリケーションでは、Connect、Disconnect、BeginFlush、EndFlush など、ピンの状態を変更するメソッドを呼び出IPinさないでください。 ピンを接続するには、アプリケーションで IGraphBuilder の メソッドを使用する必要があります。
フィルター開発者: CBasePin、CBaseInputPin、および CBaseOutputPin クラスは、このインターフェイスを実装します。 他の基底クラスは、これら 3 つのクラスから派生します。
継承
IPin インターフェイスは IUnknown インターフェイスから継承されます。 IPin には、次の種類のメンバーもあります。
メソッド
IPin インターフェイスには、これらのメソッドがあります。
| IPin::BeginFlush BeginFlush メソッドは、フラッシュ操作を開始します。 (IPin.BeginFlush) |
| IPin::Connect Connect メソッドは、ピンを別のピンに接続します。 |
| IPin::ConnectedTo ConnectedTo メソッドは、接続されているピンへのポインター (存在する場合) を取得します。 |
| IPin::ConnectionMediaType ConnectionMediaType メソッドは、現在のピン接続のメディアの種類 (存在する場合) を取得します。 |
| IPin::D isconnect Disconnect メソッドは、現在のピン接続を切断します。 |
| IPin::EndFlush EndFlush メソッドは、フラッシュ操作を終了します。 (IPin.EndFlush) |
| IPin::EndOfStream EndOfStream メソッドは、フィルターに対して新しい実行コマンドが発行されるまで、追加のデータが必要ないことをピンに通知します。 |
| IPin::EnumMediaTypes EnumMediaTypes メソッドは、ピンの優先メディアの種類を列挙します。 |
| IPin::NewSegment NewSegment メソッドは、この呼び出しの後に受信したメディア サンプルがセグメントとしてグループ化され、共通の開始時刻、停止時間、およびレートでピンに通知します。 |
| IPin::QueryAccept QueryAccept メソッドは、ピンが指定されたメディアの種類を受け入れるかどうかを決定します。 |
| IPin::QueryDirection QueryDirection メソッドは、ピンの方向 (入力または出力) を取得します。 |
| IPin::QueryId QueryId メソッドは、ピンの識別子を取得します。 |
| IPin::QueryInternalConnections QueryInternalConnections メソッドは、(フィルター内で) このピンに内部的に接続されているピンを取得します。 |
| IPin::QueryPinInfo QueryPinInfo メソッドは、ピンに関する情報を取得します。 |
| IPin::ReceiveConnection ReceiveConnection メソッドは、別のピンからの接続を受け入れます。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |