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 |
---|---|
|
Êxito. |
|
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 |