IMFCaptureEngine::StartPreview メソッド (mfcaptureengine.h)

  • [アーティクル]

プレビューを開始します。

構文

HRESULT StartPreview();

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
MF_E_INVALIDREQUEST
 プレビュー シンクが初期化されませんでした。

注釈

このメソッドを呼び出す前に、 IMFCaptureSink::AddStream を呼び出してプレビュー シンクを構成します。 プレビュー シンクへのポインターを取得するには、 IMFCaptureEngine::GetSink を呼び出します。

このメソッドは非同期です。 メソッドが成功コードを返す場合、呼び出し元は IMFCaptureEngineOnEventCallback::OnEvent メソッドを介してMF_CAPTURE_ENGINE_PREVIEW_STARTED イベントを受け取ります。 メソッドが成功した後、操作は非同期的に失敗する可能性があります。 その場合、エラー コードは OnEvent メソッドを介して伝達されます。

プレビュー シンクが構成されたら、IMFCaptureEngine::StopPreview と IMFCaptureEngine::StartPreview を呼び出してプレビューを停止および開始できます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mfcaptureengine.h

こちらもご覧ください

IMFCaptureEngine