Método IMFCaptureSink::P repare (mfcaptureengine.h)

Prepara el receptor de captura cargando los componentes de canalización necesarios, como codificadores, procesadores de vídeo y receptores multimedia.

Sintaxis

HRESULT Prepare();

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
MF_E_INVALIDREQUEST	Solicitud no válida.

Comentarios

Llamar a este método es opcional. Este método ofrece a la aplicación la oportunidad de configurar los componentes de canalización antes de usarlos. El método es asincrónico. Si el método devuelve un código correcto, el autor de la llamada recibirá un evento de MF_CAPTURE_SINK_PREPARED a través del método IMFCaptureEngineOnEventCallback::OnEvent . Una vez recibido este evento, llame a IMFCaptureSink::GetService para configurar componentes individuales.

Antes de llamar a este método, configure el receptor de captura agregando al menos una secuencia. Para agregar una secuencia, llame a IMFCaptureSink::AddStream.

Se produce un error en el método Prepare si el receptor de captura está actualmente en uso. Por ejemplo, al llamar a Prepare en el receptor de versión preliminar se produce un error si el motor de captura está actualmente en versión preliminar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mfcaptureengine.h

Consulte también

IMFCaptureSink