IMFCaptureSink::P repare-Methode (mfcaptureengine.h)

  • Artikel

Bereitet die Erfassungssenke vor, indem alle erforderlichen Pipelinekomponenten wie Encoder, Videoprozessoren und Mediensenken geladen werden.

Syntax

HRESULT Prepare();

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
MF_E_INVALIDREQUEST
 Ungültige Anforderung.

Hinweise

Der Aufruf dieser Methode ist optional. Diese Methode gibt der Anwendung die Möglichkeit, die Pipelinekomponenten zu konfigurieren, bevor sie verwendet werden. Die Methode ist asynchron. Wenn die Methode einen Erfolgscode zurückgibt, empfängt der Aufrufer über die IMFCaptureEngineOnEventCallback::OnEvent-Methode ein MF_CAPTURE_SINK_PREPARED-Ereignis. Nachdem dieses Ereignis empfangen wurde, rufen Sie IMFCaptureSink::GetService auf, um einzelne Komponenten zu konfigurieren.

Konfigurieren Sie vor dem Aufrufen dieser Methode die Erfassungssenke, indem Sie mindestens einen Stream hinzufügen. Um einen Stream hinzuzufügen, rufen Sie IMFCaptureSink::AddStream auf.

Die Prepare-Methode schlägt fehl, wenn die Erfassungssenke derzeit verwendet wird. Beispielsweise schlägt der Aufruf von Prepare für die Vorschausenke fehl, wenn sich die Erfassungs-Engine derzeit in der Vorschau befindet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfcaptureengine.h

Weitere Informationen

IMFCaptureSink