Metodo FMCaptureSink::P repare (mfcaptureengine.h)

Prepara il sink di acquisizione caricando tutti i componenti della pipeline necessari, ad esempio codificatori, processori video e sink multimediali.

Sintassi

HRESULT Prepare();

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_INVALIDREQUEST	Richiesta non valida.

Commenti

La chiamata a questo metodo è facoltativa. Questo metodo consente all'applicazione di configurare i componenti della pipeline prima che vengano usati. Il metodo è asincrono. Se il metodo restituisce un codice di esito positivo, il chiamante riceverà un evento MF_CAPTURE_SINK_PREPARED tramite il metodo IMFCaptureEngineOnEventCallback::OnEvent . Dopo aver ricevuto questo evento, chiamare FMCaptureSink::GetService per configurare singoli componenti.

Prima di chiamare questo metodo, configurare il sink di acquisizione aggiungendo almeno un flusso. Per aggiungere un flusso, chiamare FMCaptureSink::AddStream.

Il metodo Prepare ha esito negativo se il sink di acquisizione è attualmente in uso. Ad esempio, la chiamata Di preparazione nel sink di anteprima ha esito negativo se il motore di acquisizione è attualmente in anteprima.

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

FMCaptureSink