IRTC::Pause method

The Pause method pauses the current capture.

Syntax

HRESULT STDMETHODCALLTYPE Pause();

Parameters

This method has no parameters.

Return value

If the method is successful, the return value is NMERR_SUCCESS.

If the method is unsuccessful, the return value is one of the following error codes:

Return code Description
NMERR_CAPTURE_PAUSED
The capture is already paused.
NMERR_NOT_CAPTURING
The NPP is not capturing data. Call IRTC::Start to start the capture.
NMERR_NOT_CONNECTED
The NPP is not connected to the network. Call IRTC::Connect to connect the NPP to the network.
NMERR_NOT_REALTIME
The NPP is connected to the network but not with the IRTC::Connect method.

Remarks

While the capture is in a paused state, new frames are not captured until the IRTC::Resume method is called to restart the capture.

When you use the IRTC::Pause and IRTC::Resume methods to control the capture, Network Monitor continues to add conversation statistics whenever the capture is running.

To restart the capture call IRTC::Resume. To stop the capture, call IRTC::Stop.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

See also

IRTC

IRTC::Connect

IRTC::Resume

IRTC::Start

IRTC::Stop