IltmmCapture::PauseCapture

#include "ltmm.h"

C Syntax	HRESULT IltmmCapture_PauseCapture(pCapture)
C++ Syntax	HRESULT PauseCapture()

IltmmCapture *pCapture;

/* pointer to an interface */

Pauses the capture graph.

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Places the object in the ltmmCapture_State_Paused state. The object must be in the ltmmCapture_State_Pending or ltmmCapture_State_Running state prior to calling this function. To resume capturing, call IltmmCapture::RunCapture.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:	IltmmCapture::get_State, IltmmCapture::ReadyCapture, IltmmCapture::StopCapture, IltmmCapture::StartCapture, ltmmCapture_Mode Constants, IltmmCapture::RunCapture
Topics:	Multimedia Function Group

Example

For a C example, refer to Advanced Capture Application for C.

For a C++ example, refer to Advanced Capture Application for C++.