Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |