CBasePin.CBasePin コンストラクター

  • [アーティクル]

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

コンストラクター メソッド。

構文

CBasePin(
   TCHAR         *pObjectName,
   CBaseFilter   *pFilter,
   CCritSec      *pLock,
   HRESULT       *phr,
   LPCWSTR       pName,
   PIN_DIRECTION dir
);

パラメーター

pObjectName

オブジェクトのデバッグ名を含む文字列。 詳細については、「 CBaseObject」を参照してください。

pFilter

このピンを作成したフィルターへのポインター。

プロック

状態の変更をシリアル化するために使用される CCritSec ロックへのポインター。 フィルター ロックと同じクリティカル セクションである CBaseFilter::m_pLockを指定できます。

Phr

メソッドの成功または失敗を示す HRESULT 値を受け取る変数へのポインター。 オブジェクトを作成する前に、値を S_OKに初期化します。 値は、エラーが発生した場合にのみ変更されます。

pName

ピンの名前を含むワイド文字列。 詳細については、「 CBasePin::QueryPinInfo」を参照してください。

dir

ピンの方向を指定する PIN_DIRECTION 列挙体のメンバー。

解説

pLock で指定されたクリティカル セクションは、接続状態、アロケーターの選択、メディアの種類、フラッシュ操作の状態など、ピンの状態をシリアル化します。 ストリーミング操作をシリアル化するには、この重要なセクションを使用しないでください。 詳細については、「フィルター グラフのData Flow」を参照してください。

フィルターによってコンストラクター メソッドにピンが作成される可能性があるため、この時点で pFilter ポインターが有効なオブジェクトを参照していない可能性があります。 ポインターを格納しますが、ピンのコンストラクター内では逆参照しないでください。

要件

要件 値
ヘッダー
Amfilter.h (Stream.h を含む)
ライブラリ
Strmbase.lib (小売ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CBasePin クラス