IMFCaptureEngine：：TakePhoto 方法 (mfcaptureengine.h)

從影片串流擷取仍然影像。

Syntax

HRESULT TakePhoto();

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

呼叫此方法之前，請先呼叫 IMFCaptureSink：：AddStream 來設定相片接收。 若要取得相片接收的指標，請呼叫 IMFCaptureEngine：：GetSink。

這個方法是非同步方法。 如果方法傳回成功碼，呼叫端會透過IMFCaptureEngineOnEventCallback：：OnEvent方法收到MF_CAPTURE_ENGINE_PHOTO_TAKEN事件。 方法成功之後，作業可能會以異步方式失敗。 如果是，則會透過 OnEvent 方法傳達錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	mfcaptureengine.h

另請參閱

IMFCaptureEngine