Metodo IMFCaptureEngine::StartPreview (mfcaptureengine.h)

Avvia l'anteprima.

Sintassi

HRESULT StartPreview();

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_INVALIDREQUEST	Il sink di anteprima non è stato inizializzato.

Commenti

Prima di chiamare questo metodo, configurare il sink di anteprima chiamando IMFCaptureSink::AddStream. Per ottenere un puntatore al sink di anteprima, chiamare IMFCaptureEngine::GetSink.

Questo metodo è asincrono. Se il metodo restituisce un codice di esito positivo, il chiamante riceverà un evento MF_CAPTURE_ENGINE_PREVIEW_STARTED tramite il metodo IMFCaptureEngineOnEventCallback::OnEvent . L'operazione può avere esito negativo in modo asincrono dopo che il metodo ha esito positivo. In tal caso, il codice di errore viene trasmesso tramite il metodo OnEvent .

Dopo aver configurato il sink di anteprima, è possibile arrestare e avviare l'anteprima chiamando IMFCaptureEngine::StopPreview e IMFCaptureEngine::StartPreview.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfcaptureengine.h

Vedi anche

IMFCaptureEngine