IMFCaptureEngine::StartPreview メソッド (mfcaptureengine.h)
プレビューを開始します。
構文
HRESULT StartPreview();
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
正常終了しました。 |
|
プレビュー シンクが初期化されませんでした。 |
注釈
このメソッドを呼び出す前に、 IMFCaptureSink::AddStream を呼び出してプレビュー シンクを構成します。 プレビュー シンクへのポインターを取得するには、 IMFCaptureEngine::GetSink を呼び出します。
このメソッドは非同期です。 メソッドが成功コードを返す場合、呼び出し元は IMFCaptureEngineOnEventCallback::OnEvent メソッドを介してMF_CAPTURE_ENGINE_PREVIEW_STARTED イベントを受け取ります。 メソッドが成功した後、操作は非同期的に失敗する可能性があります。 その場合、エラー コードは OnEvent メソッドを介して伝達されます。
プレビュー シンクが構成されたら、IMFCaptureEngine::StopPreview と IMFCaptureEngine::StartPreview を呼び出してプレビューを停止および開始できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mfcaptureengine.h |