次の方法で共有

CBasePropertyPage.OnConnect メソッド

  • [アーティクル]

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

メソッドは OnConnect 、プロパティ ページに関連付けられているオブジェクトへの IUnknown ポインターを提供します。

構文

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

パラメーター

pUnknown

オブジェクトの IUnknown インターフェイスへのポインター。

戻り値

基底クラスの実装では、S_OKが返されます。

解説

CBasePropertyPage::SetObjects メソッドは メソッドをOnConnect呼び出します。 pUnknown で指定されたオブジェクトへのポインターを格納するには、このメソッドをオーバーライドします。 pUnknown ポインター自体を格納することも、そのポインターに他のインターフェイスを照会することもできます。 pUnknown ポインターを格納する場合は、 を返す前に OnConnectAddRef を呼び出します。

CBasePropertyPage::OnActivate メソッドで、格納されているポインター (またはポインター) を使用してダイアログ プロパティの初期値を取得します。 CBasePropertyPage::OnApplyChanges メソッドで、変更をオブジェクトに適用し直します。 CBasePropertyPage::OnDisconnect メソッドのすべてのポインターを解放します。

例

HRESULT CMyProp::OnConnect(IUnknown *pUnk)
{
    ASSERT(m_pOwningFilter == NULL);
    HRESULT hr;
    // Query pUnk for the filter's custom interface.
    hr = pUnk->QueryInterface(IID_ISomeCustomInterface,
             reinterpret_cast<void**>(&m_pOwningFilter));
    return hr;
}

要件

要件 値
ヘッダー
Cprop.h (Streams.h を含む)
ライブラリ
Strmbase.lib (製品版ビルド);
Strmbasd.lib (デバッグ ビルド)

関連項目

CBasePropertyPage クラス