IMFCaptureEngine::TakePhoto-Methode (mfcaptureengine.h)

  • Artikel

Erfasst ein Standbild aus dem Videostream.

Syntax

HRESULT TakePhoto();

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Konfigurieren Sie vor dem Aufrufen dieser Methode die Fotosenke, indem Sie IMFCaptureSink::AddStream aufrufen. Um einen Zeiger auf die Fotosenke zu erhalten, rufen Sie IMFCaptureEngine::GetSink auf.

Diese Methode ist asynchron. Wenn die Methode einen Erfolgscode zurückgibt, empfängt der Aufrufer über die IMFCaptureEngineOnEventCallback::OnEvent-Methode ein MF_CAPTURE_ENGINE_PHOTO_TAKEN-Ereignis. Der Vorgang kann asynchron fehlschlagen, nachdem die Methode erfolgreich war. Wenn ja, wird der Fehlercode über die OnEvent-Methode übermittelt.

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

IMFCaptureEngine