Compartilhar via


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

Prepara o coletor de captura carregando todos os componentes de pipeline necessários, como codificadores, processadores de vídeo e coletores de mídia.

Sintaxe

HRESULT Prepare();

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
MF_E_INVALIDREQUEST
Solicitação inválida.

Comentários

Chamar esse método é opcional. Esse método dá ao aplicativo a oportunidade de configurar os componentes de pipeline antes que eles sejam usados. O método é assíncrono. Se o método retornar um código de êxito, o chamador receberá um evento MF_CAPTURE_SINK_PREPARED por meio do método IMFCaptureEngineOnEventCallback::OnEvent . Depois que esse evento for recebido, chame IMFCaptureSink::GetService para configurar componentes individuais.

Antes de chamar esse método, configure o coletor de captura adicionando pelo menos um fluxo. Para adicionar um fluxo, chame IMFCaptureSink::AddStream.

O método Prepare falhará se o coletor de captura estiver em uso no momento. Por exemplo, chamar Preparar no coletor de visualização falhará se o mecanismo de captura estiver sendo visualizado no momento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfcaptureengine.h

Confira também

IMFCaptureSink