ILMScrCap Interface

This is the interface for the LEAD Screen Capture Filter.

Data types:

typedef [v1_enum] enum PanToWindowConstants

{

PANTO_WINDOWUNDERCURSOR = -1,

PANTO_ACTIVEWINDOW = -2

} PanToWindowConstants;

typedef [v1_enum] enum WindowSelectStatusConstants

{

WINDOW_SELECT_STATUS_UPDATE = 0,

WINDOW_SELECT_STATUS_SELECTED = 1,

WINDOW_SELECT_STATUS_CANCELED = 2,

} WindowSelectStatusConstants;

   typedef [v1_enum] enum CaptureSourceConstants
   {
      CAPTURE_FULLSCREEN   = 0,
      CAPTURE_ACTIVEWINDOW = 1,
      CAPTURE_ACTIVECLIENT = 2,

CAPTURE_SELECTEDWINDOW = 3
} CaptureSourceConstants;

typedef [v1_enum] enum CursorIconConstants
{
   CURSOR_ARROW = 0,
   CURSOR_IBEAM = 1,
   CURSOR_WAIT = 2,
   CURSOR_CROSS = 3,
   CURSOR_UPARROW = 4,
   CURSOR_SIZENWSE = 5,
   CURSOR_SIZENESW = 6,
   CURSOR_SIZEWE = 7,
   CURSOR_SIZENS = 8,
   CURSOR_SIZEALL = 9,
   CURSOR_NO = 10,
   CURSOR_APPSTARTING = 11,
   CURSOR_HELP = 12,
   CURSOR_ACTUAL = 13,
   CURSOR_CUSTOM = 14
} CursorIconConstants;

typedef [v1_enum] enum WindowCaptureOptionConstants
{
CAPTUREOPTION_VISIBLE_WINDOW = 0,
CAPTUREOPTION_ALL_WINDOW = 1,
} WindowCaptureOptionConstants;

typedef [v1_enum] enum NotifyCallbackConstants

{

NOTIFY_PRERUN_AREACHANGE = 0x0000,

NOTIFY_CLOSE = 0x0001,

NOTIFY_MINIMIZE = 0x0002,

NOTIFY_AREACHANGE = 0x0004,

NOTIFY_CAPWIDTH_EXCEEDED_LIMIT = 0x0008,

NOTIFY_CAPHEIGHT_EXCEEDED_LIMIT = 0x010,

} NotifyCallbackConstants;

typedef [v1_enum] enum SourceCloseConstants
{
   CLOSE_STOP_CAPTURING = 0,
   CLOSE_CONTNUE_FROM_LAST_POS = 1,
   CLOSE_FILL_COLOR = 2
} SourceCloseConstants;

typedef [v1_enum] enum SourceMinimizeConstants
{
   MINIMIZE_PAUSE_CAPTURING = 0,
   MINIMIZE_STOP_CAPTURING = 1,
   MINIMIZE_CONTINUE_FROM_LAST_POS = 2,
   MINIMIZE_FILL_COLOR = 3
} SourceMinimizeConstants;

typedef [v1_enum] enum SourceAreaChangeConstants
{
AREACHANGE_CAPTURE_OTHER_WINDOWS = 0,
AREACHANGE_FILL_UNCOVERED_AREA = 1,
} SourceAreaChangeConstants;

typedef [v1_enum] enum EffectShapeConstants

{

EFFECTSHAPE_NON = 0,

EFFECTSHAPE_RINGS = 1,

EFFECTSHAPE_CIRCLE = 2,

EFFECTSHAPE_SUN = 3,

} EffectShapeConstants;

typedef [v1_enum] enum MouseHighlightConstants

{

MOUSEHIGHLIGHT_NON = 0,

MOUSEHIGHLIGHT_SQUARE = 1,

MOUSEHIGHLIGHT_RECTANGLE = 2,

MOUSEHIGHLIGHT_ROUNDEDRECTANGLE = 3,

MOUSEHIGHLIGHT_CIRCLE = 4,

MOUSEHIGHLIGHT_ELLIPSE = 5,

} MouseHighlightConstants;

typedef [v1_enum] enum MouseHighlightModeConstants

{

HIGHLIGHTMODE_TRANSLUCENT = 0,

HIGHLIGHTMODE_OPAQUE = 1,

} MouseHighlightModeConstants;

typedef [v1_enum] enum UserEventsNotifyConstants

{

USEREVENT_LBUTTONDOWN = 0x001,

USEREVENT_LBUTTONUP = 0x002,

USEREVENT_RBUTTONDOWN = 0x004,

USEREVENT_RBUTTONUP = 0x008,

USEREVENT_MOUSEMOVE = 0x010,

USEREVENT_MOUSEWHEEL = 0x020,

USEREVENT_KEYDOWN = 0x040,

USEREVENT_KEYUP = 0x080,

USEREVENT_SYSKEYDOWN = 0x100,

USEREVENT_SYSKEYUP = 0x200

} UserEventsNotifyConstants;

typedef [v1_enum] enum OutlineShapeConstants

{

OUTLINESHAPE_RECTANGLE = 0x00,

OUTLINESHAPE_CORNER = 0x01,

} OutlineShapeConstants;

typedef [v1_enum] enum CaptureAlignmentConstants

{

CAPALIGNMENT_LEFT = 0x001,

CAPALIGNMENT_TOP = 0x002,

CAPALIGNMENT_RIGHT = 0x004,

CAPALIGNMENT_BOTTOM = 0x008,

CAPALIGNMENT_HCENTER = 0x010,

CAPALIGNMENT_VCENTER = 0x020,

} CaptureAlignmentConstants;

Interface Properties:

Type	Property name		Description
CaptureSourceConstants	CaptureSource		Sets or gets the capture source type. Possible values are: CAPTURE_FULLSCREEN: The filter will capture from the full screen (desktop). CAPTURE_ACTIVEWINDOW: The filter will capture from the active window. CAPTURE_ACTIVECLIENT: The filter will capture from the client area of the active window. CAPTURE_WINDOW: The filter will capture from a specific window.
long	SourceWindowHandle		Sets or gets the window handle of the capture source. Changing this property will automatically set the CaptureSource property of this interface to CAPTURE_WINDOW.
float	CaptureFrameRate		Sets or gets the capture frame rate in frames per second. The filter will attempt to capture at this rate if possible. Possible values range from 0.1 to 30.0 frames per second.
VARIANT_BOOL	ConnectionStatus		Gest the connection status of the filter output. Possible values are: VARIANT_TRUE: The filter output pin is connected. VARIANT_FALSE: The filter output pin is not connected.
CursorIconConstants	CursorIcon		Sets or gets cursor icon. Possible values are: CURSOR_ARROW, CURSOR_IBEAM, CURSOR_WAIT, CURSOR_CROSS, CURSOR_UPARROW, CURSOR_SIZENWSE, CURSOR_SIZENESW, CURSOR_SIZEWE, CURSOR_SIZENS, CURSOR_SIZEALL, CURSOR_NO, CURSOR_APPSTARTING, CURSOR_HELP, CURSOR_ACTUAL, CURSOR_CUSTOM. If the value is CURSOR_ACTUAL, then the actual cursor icon on the screen will be captured. If the value is CURSOR_CUSTOM, then the custom cursor icon that is set using the CustomCursor property of this interface will be captured.
long	CustomCursor		Sets or gets the custom cursor handle. The custom cursor will be used only if the CursorIcon property of this interface is set to CURSOR_CUSTOM.
VARIANT_BOOL	EnableRegion		Enables or disables using the region coordinates. The region will be limited to the dimensions of the current capture source.
long	FillColor		Sets or gets the fill color used to fill areas of the video under certain conditions. This property accepts/retrieves a COLORREF value. For more information, refer to the OnSourceClose property, OnSourceMinimize property and OnSourceAreaChange property of this interface.
long	NotifyCallback		Determines what events will call the NotifyCallbackProc of the ILMScrCapUserCallback interface. Possible values are: NOTIFY_PRERUN_AREACHANGE: Call NotifyCallbackProc of the ILMScrCapUserCallback interface if the capture source area has changed while the filter is not in the running state. The notification is sent once the filter is run. NOTIFY_CLOSE: Call NotifyCallbackProc of the ILMScrCapUserCallback interface when the capture source is closed. NOTIFY_MINIMIZE: Call NotifyCallbackProc of the ILMScrCapUserCallback interface when the capture source is minimized. NOTIFY_AREACHANGE: Call NotifyCallbackProc of the ILMScrCapUserCallback interface when the capture area is changed. NOTIFY_CAPWIDTH_EXCEEDED_LIMIT: Call NotifyCallbackProc of the ILMScrCapUserCallback interface when using the selection tool and the selected area width exceeded the LowerWidthLimit or UpperWidthLimit values. NOTIFY_CAPHEIGHT_EXCEEDED_LIMIT: Call NotifyCallbackProc of the ILMScrCapUserCallback interface when using the selection tool and the selected area height exceeded the LowerHeightLimit or UpperHeightLimit values. These values may also be combined using logical OR.
SourceAreaChangeConstants	OnSourceAreaChange		Determines what action to take if the capture source area is resized or the visible area of the capture source is covered by other windows. This property has no effect if the capture source is set to full screen. Possible values are: AREACHANGE_CAPTURE_OTHER_WINDOWS: Capture the contents under the resized or/and convered area. AREACHANGE_FILL_UNCOVERED_AREA: Fill the resized or/and covered area with the color specified in the FillColor property of this interface.
SourceCloseConstants	OnSourceClose		Determines what action to take if the capture source is closed. This property has no effect if the capture source is set to full screen. Possible values are: CLOSE_STOP_CAPTURING: Stop capturing; stop the graph. CLOSE_CONTINUE_FROM_LAST_POS: Continue capturing the contents of the last position the capture source was occupying. CLOSE_FILL_COLOR: Fill the capture buffer with the color specified in the FillColor property of this interface.
SourceMinimizeConstants	OnSourceMinimize		Determines what action to take if the capture source is minimized. This property has no effect if the capture source is set to full screen. Possible values are: MINIMIZE_PAUSE_CAPTURING: Pause capturing until the capture source is restored. MINIMIZE_STOP_CAPTURING: Stop capturing; stop the graph. MINIMIZE_CONTINUE_FROM_LAST_POS: Continue capturing the contents of the last position the capture source was occupying. MINIMIZE_FILL_COLOR: Fill the capture buffer with the color specified in the FillColor property of this interface.
long	RegionBottom		Sets or gets the bottom boundary of the region. The value range is from RegionTop property + 1 to SourceHeight property.
long	RegionLeft		Sets or gets the left boundary of the region. The value range is from 0 to RegionRight property.
long	RegionRight		Sets or gets the right boundary of the region. The value range is from RegionLeft property + 1 to SourceWidth property.
long	RegionTop		Sets or gets the top boundary of the region. The value range is from 0 to RegionBottom property.
VARIANT_BOOL	ShowCrossLines		Shows or hides the cross lines cursor when the SelectRegionTool method is being used. Possible values are: VARIANT_TRUE: Use the cross lines cursor. VARIANT_FALSE: Use the normal arrow cursor.
VARIANT_BOOL	ShowCursor		Shows or hides the cursor in the capture stream. Possible values are: VARIANT_TRUE: The mouse cursor will be captured with the other contents. VARIANT_FALSE: The mouse cursor will not be captured.
VARIANT_BOOL	ShowPanWindow		Shows or hides the pan window when the SelectRegionTool method is being used. The pan window provides up to 10X zooming. Use the + and keys for zooming in and out. The panned area is the area under the mouse cursor.
VARIANT_BOOL	ShowWHInfo		Shows or hides the region width and height information while dragging the mouse to select the region, when the SelectRegionTool method is being used. The width and height information is displayed near the cursor.
VARIANT_BOOL	ShowXYPosInfo		Shows or hides the X and Y coordinates while dragging the mouse to select a region when the SelectRegionTool mehtod is being used. The X and Y coordinate information is displayed near the cursor.
long	SourceHeight		(Read only) Retrieves the actual height in pixels of the capture area.
long	SourceWidth		(Read only) Retrieves the actual width in pixels of the capture area.
VARIANT_BOOL	TrackWindow		Enables or disables the track window option. Possible values are: VARIANT_TRUE: Capture the contents of the window area's current location, even if the window is moved. VARIANT_FALSE: Capture the contents of the window at its original position, even if the window is moved. This property has no effect if the capture source is set to full screen.
WindowCaptureOptionConstants	WindowCaptureOption		Sets or gets a value that indicates what to capture from the window. Possible values are: CAPTUREOPTION_VISIBLE_WINDOW: Capture the visible area only. CAPTUREOPTION_ALL_WINDOW: Capture the entire window area. This property has no effect if the capture source is set to full screen.
VARIANT_BOOL		ManualMode		Enables or disables the manual capturing mode. In manual capturing mode, frames are pushed downstream on user request (no frames will be captured if CaptureFrames method not called).
EffectShapeConstants		OnRightBtnClkEffectShape		Sets or gets a value that indicates the effect shape when the right button click. Possible values are: EFFECTSHAPE_NON: dont do any effect. EFFECTSHAPE_RINGS: display the rings effect when the mouse clicks. EFFECTSHAPE_CIRCLE: display the circle effect when the mouse clicks. EFFECTSHAPE_SUN: display the sun effect when the mouse clicks.
Long		OnLeftBtnClkEffectColor		Sets or gets the color effect shape for the left mouse button clicks. This property accepts/retrieves a COLORREF value.
Long		OnRightBtnClkEffectColor		Sets or gets the color effect shape for the right mouse button clicks. This property accepts/retrieves a COLORREF value.
Long		OnLeftBtnClkEffectSize		Sets or gets the shape effect size when the left mouse button clicks.
Long		OnRightBtnClkEffectSize		Sets or gets the shape effect size when the right mouse button clicks.
VARIANT_BOOL		EnableOutline		Display a frame (outline) around the captured source.
OutlineShapeConstants		OutlineShape		Sets or gets a value that indicates the outline shape. Possible values are: OUTLINESHAPE_RECTANGLE: The outline shape is a rectangular shape. OUTLINESHAPE_CORNER: the outline shape is a corner shape.
MouseHighlightConstants		MouseHighlight		Sets or gets a value that indicates the mouse highlight. Possible values are: MOUSEHIGHLIGHT_NON: dont do any mouse shape highlight. MOUSEHIGHLIGHT_SQUARE: display a square shape highlight over the mouse. MOUSEHIGHLIGHT_RECTANGLE: display a rectangular shape highlight over the mouse. MOUSEHIGHLIGHT_ROUNDEDRECTANGLE: display a rounded rectangle shape highlight over the mouse. MOUSEHIGHLIGHT_CIRCLE: display a circle shape highlight over the mouse. MOUSEHIGHLIGHT_ELLIPSE: display an ellipse shape highlight over the mouse.
Long		MouseHighlightSize		Sets or gets the mouse highlight size. This property accepts/retrieves a COLORREF value.
long		MouseHighlightColor		Sets or gets the mouse highlight color. This property accepts/retrieves a COLORREF value.
MouseHighlightModeConstants		MouseHighlightMode		Change the mouse highlight mode. Possible values are: HIGHLIGHTMODE_TRANSLUCENT: The mouse highlight is translucent. HIGHLIGHTMODE_OPAQUE: The mouse highlight is opaque.
Long		UserEventsNotifyCallback		Determines what events will call the MouseEventsProc and/or KeyboardEventsProc of the ILMScrCapUserEventsCallback interface. Possible values are: USEREVENT_LBUTTONDOWN: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface if the left mouse button pressed. USEREVENT_LBUTTONUP: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface if the left mouse button released. USEREVENT_RBUTTONDOWN: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface if the right mouse button pressed. USEREVENT_RBUTTONUP: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface if the left mouse button released. USEREVENT_MOUSEMOVE: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface when the mouse moves. USEREVENT_MOUSEWHEEL: Call MouseEventsProc of the ILMScrCapUserEventsCallback interface when the mouse wheel is rotated. USEREVENT_KEYDOWN: Call KeyboardEventsProc of the ILMScrCapUserEventsCallback interface when a nonsystem key is pressed. USEREVENT_KEYUP Call KeyboardEventsProc of the ILMScrCapUserEventsCallback interface when a nonsystem key is released. USEREVENT_SYSKEYDOWN: Call KeyboardEventsProc of the ILMScrCapUserEventsCallback interface when the F10 key pressed (which activates the menu bar) or holds down the ALT key and then presses another key. USEREVENT_SYSKEYUP: Call KeyboardEventsProc of the ILMScrCapUserEventsCallback interface when the key that was pressed while the ALT key was held down released.
VARIANT_BOOL		ManualMode		Enable or disable the manual capturing mode. In manual capturing mode, frames are pushed downstream on user request (no frames will be captured if CaptureFrames method not called).
Long		CaptureAlignment		Sets or gets the source capture alignments from the capture area. It also has an effect on the panning and zooming process. Possible values are: CAPALIGNMENT_LEFT: the source capture will be from the left. CAPALIGNMENT_TOP: the source capture will be from the top. CAPALIGNMENT_RIGHT: the source capture will be from the right. CAPALIGNMENT_BOTTOM: the source capture will be from the bottom. CAPALIGNMENT_HCENTER: the source capture will be from horizontal center. CAPALIGNMENT_VCENTER: the source capture will be from vertical center.
long		OutlineColor		Sets or gets the outline shape color. This property accepts/retrieves a COLORREF value.
Long		LowerWidthLimit		Sets or gets the minimum region width that can be selected when using the SelectRegionTool method.
Long		UpperWidthLimit		Sets or gets the maximum region width that can be selected when using the SelectRegionTool method.
Long		LowerHeightLimit		Sets or gets the minimum region height that can be selected when using the SelectRegionTool method.
Long		UpperHeightLimit		Sets or gets the maximum region height that can be selected when using the SelectRegionTool method.
Long		RgnSelToolStepSizeX		Sets or gets the X step size of the selection process when using SelectRegionTool method. (e.g If this value is 2, the selection X steps will be 2 by 2 pixels).
Long		RgnSelToolStepSizeY		Sets or gets the Y step size of the selection process when using SelectRegionTool method. (e.g If this value is 2, the selection Y steps will be 2 by 2 pixels).
Long		RgnSelToolWarningColor		Sets or gets the selection tool warning color.
VARIANT_BOOL		RgnSelToolLockSelOnLimit		Enables or disables the lock selection when the region width and/or height reach the limits. If this is VARIANT_TRUE, the selection will be locked. If this is VARIANT_FALSE and the ShowWHInfo property is VARIANT_TRUE, the Width/Height info dialog color will be changed with RgnSelToolWarningColor color.
EffectShapeConstants		OnLeftBtnClkEffectShape		Sets or gets a value that indicates the effect shape when the left button click. Possible values are: EFFECTSHAPE_NON: dont display any effect whe the mouse clicks. EFFECTSHAPE_RINGS: display the rings effect when the mouse clicks. EFFECTSHAPE_CIRCLE: display the circle effect when the mouse clicks. EFFECTSHAPE_SUN: display the sun effect when the mouse clicks.
EffectShapeConstants		OnRightBtnClkEffectShape		Sets or gets a value that indicates the effect shape when the right button click. Possible values are: EFFECTSHAPE_NON: dont do any effect. EFFECTSHAPE_RINGS: display the rings effect when the mouse clicks. EFFECTSHAPE_CIRCLE: display the circle effect when the mouse clicks. EFFECTSHAPE_SUN: display the sun effect when the mouse clicks.
long		OnLeftBtnClkEffectColor		Sets or gets the color effect shape for the left mouse button clicks. This property accepts/retrieves a COLORREF value.
long		OnRightBtnClkEffectColor		Sets or gets the color effect shape for the right mouse button clicks. This property accepts/retrieves a COLORREF value.
long		OnLeftBtnClkEffectSize		Sets or gets the shape effect size when the left mouse button clicks.
long		OnRightBtnClkEffectSize		Sets or gets the shape effect size when the right mouse button clicks.
VARIANT_BOOL		EnablePanning		Enable or disable mouse panning. If the value is VARIANT_TRUE then it will override the region and window options and the capture source will be the area around the mouse that can be determined using the PanningWidth and PanningHeight properties.
Long		ZoomFactor		Change the zoom factor. Possible value between 10 and 800. Where 100 causes no zoom (normal size).

Interface Methods:

HRESULT PanToXY(long lXPos, long lYPos)

Parameters

lXPos	The X Coordinates on the screen.
lYPos	The Y Coordinates on the screen.

Description

To move the capture area to the X and Y coordinates on the screen. This is valid only if the EnablePanning and EnableRegion properties are true. The CaptureAlignment property determines the source capture alignments from the capture area.

Return

S_OK if successful, E_UNEXPECTED otherwise.

HRESULT PanToWindow(long lHwnd, VARIANT_BOOL vbFollow, VARIANT_BOOL vbFit)

Parameters

lHwnd

The window handle to pan to it, or use one of the following values:

PANTO_WINDOWUNDERCURSOR	To pan to the window that is under the user cursor.
PANTO_ACTIVEWINDOW	To pan to the window that is active.

vbFollow

Determine if the region needs to follow the window when its position changed. Pass VARIANT_TRUE to follow the window, pass VAIRNAT_FALSE to do not.

vbFit

Determine if the region needs to fit to the window. Pass VARIANT_TRUE to fit the window, pass VAIRNAT_FALSE to do not.

Description

To move the capture region to the passed window handle coordinates. This is valid only if the EnablePanning and EnableRegion properties are true. The CaptureAlignment property determines the source capture alignments from the capture area.

HRESULT PanToCursor(VARIANT_BOOL vbFollow)

Parameters

vbFollow

If this is VARIANT_TRUE, the region will track the cursor when it moves.

Description

To move the capture region to the cursor position. This is valid only if the EnablePanning and EnableRegion properties are true. The CaptureAlignment property determines the source capture alignments from the capture area.

HRESULT SetZoomStepsInfo(long lSteps, long lMinStepSize)

Parameters

lSteps	The zoom steps value between the old zoom level and new zoom level.
lMinStepSize	The minimum step size in pixels. If the increase/decrease size will be less than lMinStepSize value, then the increase/decrease size will be lMinStepSize value.

Description

Sets the zoom steps information to change the zoom level from the old to the new level with steps. To change the zoom level without any steps, pass 0 to lSteps parameter.

Return

S_OK if successful, S_FALSE otherwise.

HRESULT GetZoomStepsInfo(long *plSteps, long *plMinStepSize)

Parameters

PlSteps	Pointer to receive the current zoom steps value.
plMinStepSize	Pointer to receive the current minimum step size in pixels.

Description

Gets the current zoom steps information.

Return

S_OK if successful, S_E_POINTER otherwise.

HRESULT SetPanStepsInfo(long lSteps, long lMinStepSize)

Parameters

lSteps	The pan steps value between the old position and new position.
lMinStepSize	The minimum step size in pixels. If the movement size will be less than lMinStepSize value, then the movement size will be lMinStepSize value.

Description

Sets the pan steps information to change the movement from the old to the new positions with steps. To set the movement without any steps, pass 0 to lSteps parameter.

Return

S_OK if successful, S_FALSE otherwise.

HRESULT GetPanStepsInfo(long *plSteps, long *plMinStepSize)

Parameters

PlSteps	Pointer to receive the current pan steps value.
plMinStepSize	Pointer to receive the current minimum step size in pixels.

Description

Gets the current movement steps information.

Return

S_OK if successful, E_POINTER otherwise.

HRESULT ResetToDefaults()

Description

Reset the screen capture options values to the default values.

Return

S_OK

HRESULT CaptureFrames(long lFramesNumber)

Description

Use CaptureFrames method to force the number of frames (determined by lFramesNumber parameter) to be captured. This method must be called in the manual mode; otherwise it will return a wrong state error.

Return

S_OK if successful, VFW_E_WRONG_STATE otherwise.

HRESULT RefreshSource()

Description

To Refresh the capture source coordinates before running

Return

S_OK value.

HRESULT SelectRegionTool ()

Description

Activates the region selection tool for selecting a region of the current desktop. To select a region, press and hold the left mouse button and drag the mouse until the desired region is outlined. Release the mouse button to complete the selection. To cancel the selection process, press the ESC key. Options are provided for displaying information while dragging the mouse.

For more information, refer to the following properties listed in the Interface Properties table above:

EnableRegion property

RegionLeft property

RegionTop property

RegionRight property

RegionBottom property

ShowPanWindow property

ShowCrossLines property

ShowXYPosInfo property

ShowWHInfo property

Return

S_OK if successful, S_FALSE otherwise.

HRESULT SelectWindowTool ()

Description

Activates the window selection tool for selecting a window as the capture source for the filter. To select the window under the cursor, press the left mouse button. To cancel the window selection process, press the ESC key. Options are provided by several properties of this interface, for displaying information while dragging the mouse.

Return

S_OK if successful, S_FALSE otherwise.

HRESULT SetCallbackObject(ILMScrCapUserCallback *pCallbackObject, long pUserData)

Parameters

pCallbackObject	a valid pointer to an ILMScrCapUserCallback interface.
pUserData	Long value to pass a pointer for user-defined data required by the callback.

Description

Sets the callback object for the Screen Capture filter. For more information, refer to ILMScrCapUserCallback interface.

Return

S_OK if successful, S_FALSE otherwise.

HRESULT ChangeSettings(VARIANT_BOOL bBegin)

Parameters

bBegin	Indicates whether the properties are being changed and the streaming paused, or the properties are being updated and streaming resumed.
	Value	Meaning
	VARIANT_TRUE	The properties are being changed and streaming has been paused.
	VARIANT_FALSE	The properties are being updated and streaming has resumed.

Description

Sets the changes affecting the capture source. You must call this method before and after setting the following properties or calling the following methods of the ILMScrCap Interface:

CaptureSource property

SourceWindowHandle property

RegionLeft property

RegionTop property

RegionRight property

RegionBottom property

SelectRegionTool method

SelectWindowTool method

Return

S_OK if successful, S_FALSE otherwise.

HRESULT CancelSourceSelection()

Description

Cancels the region or window selection process.

Return

S_OK if connected, S_FALSE otherwise.

HRESULT SetUserEventsCallbackObject(ILMScrCapUserEventsCallback *pCallbackObject, long pUserData)

Parameters

pCallbackObject	a valid pointer to an ILMScrCapUserEventsCallback interface.
pUserData	Long value to pass a pointer for user-defined data required by the callback.

Description

Sets the callback object for the user events. Pass NULL in pCallbackObject parameter to free the old callback object. For more information, refer to ILMScrCapUserEventsCallback interface.

Return

S_OK if successful, E_POINTER otherwise.