IMFCaptureEngine::TakePhoto-Methode (mfcaptureengine.h)
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 |