In This Topic ▼

ILMScrCap

This is the interface for the LEAD Screen Capture Filter.

Data Types

PanToWindowConstants

Summary

Specifies the window to pan it.

Syntax

typedef[v1_enum] enum PanToWindowConstants 
{ 
   PANTO_WINDOWUNDERCURSOR = -1, 
   PANTO_ACTIVEWINDOW = -2 
} PanToWindowConstants; 

Members

PANTO_WINDOWUNDERCURSOR

Pan to the window that is under the user cursor.

PANTO_ACTIVEWINDOW

Pan to the window that is active.

WindowSelectStatusConstants

Summary

Specifies the window selection events when the window selection tool is active.

Syntax

typedef[v1_enum] enum WindowSelectStatusConstants 
{ 
   WINDOW_SELECT_STATUS_UPDATE = 0, 
   WINDOW_SELECT_STATUS_SELECTED = 1, 
   WINDOW_SELECT_STATUS_CANCELED = 2, 
} WindowSelectStatusConstants; 

CaptureSourceConstants

Summary

Specifies the capture source type.

Syntax

typedef[v1_enum] enum CaptureSourceConstants 
{ 
   CAPTURE_FULLSCREEN = 0, 
   CAPTURE_ACTIVEWINDOW = 1, 
   CAPTURE_ACTIVECLIENT = 2, 
   CAPTURE_SELECTEDWINDOW = 3 
} CaptureSourceConstants; 

Members

CAPTURE_FULLSCREEN

This can be the entire screen (one or multiple monitors) or a region defined by screen coordinates.

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_SELECTEDWINDOW

The filter will capture from a specifically chosen window.

CursorIconConstants

Summary

Specifies the cursor icon.

Syntax

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; 

WindowCaptureOptionConstants

Summary

Specifies the area to capture from the window.

Syntax

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

Members

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.

NotifyCallbackConstants

Summary

Determines which events will call the NotifyCallbackProc of the ILMScrCapUserCallback interface.

Syntax

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; 

Members

NOTIFY_PRERUN_AREACHANGE

Call NotifyCallbackProc of the ILMScrCapUserCallback or ILMScrCapUserCallback2 interfaces 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 or ILMScrCapUserCallback2 interfaces when the capture source is closed.

NOTIFY_MINIMIZE

Call NotifyCallbackProc of the ILMScrCapUserCallback or ILMScrCapUserCallback2 interfaces when the capture source is minimized.

NOTIFY_AREACHANGE

Call NotifyCallbackProc of the ILMScrCapUserCallback or ILMScrCapUserCallback2 interfaces when the capture area is changed.

NOTIFY_CAPWIDTH_EXCEEDED_LIMIT

Call NotifyCallbackProc of the ILMScrCapUserCallback or ILMScrCapUserCallback2 interfaces 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 or ILMScrCapUserCallback2 interfaces 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.

SourceCloseConstants

Summary

Specifies the action to take when the capture source is closed.

Syntax

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

Members

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

Summary

Specifies the action to take when the capture source is minimized.

Syntax

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

Members

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.

SourceAreaChangeConstants

Summary

Specifies the action to take if the capture source area is resized or the visible area of the capture source is covered by other windows.

Syntax

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

Members

AREACHANGE_CAPTURE_OTHER_WINDOWS

Capture the contents under the resized or/and covered area.

AREACHANGE_FILL_UNCOVERED_AREA

Fill the resized or/and covered area with the color specified in the FillColor property of this interface.

EffectShapeConstants

Summary

Specifies the effect shape when the mouse left button click.

Syntax

typedef[v1_enum] enum EffectShapeConstants 
{ 
   EFFECTSHAPE_NON = 0, 
   EFFECTSHAPE_RINGS = 1, 
   EFFECTSHAPE_CIRCLE = 2, 
   EFFECTSHAPE_SUN = 3, 
} EffectShapeConstants; 

Members

EFFECTSHAPE_NON

Do not perform 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.

MouseHighlightConstants

Summary

Specifies the shape highlight over the mouse.

Syntax

typedef[v1_enum] enum MouseHighlightConstants 
{ 
   MOUSEHIGHLIGHT_NON = 0, 
   MOUSEHIGHLIGHT_SQUARE = 1, 
   MOUSEHIGHLIGHT_RECTANGLE = 2, 
   MOUSEHIGHLIGHT_ROUNDEDRECTANGLE = 3, 
   MOUSEHIGHLIGHT_CIRCLE = 4, 
   MOUSEHIGHLIGHT_ELLIPSE = 5, 
} MouseHighlightConstants; 

Members

MOUSEHIGHLIGHT_NON

Do not perform 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.

MouseHighlightModeConstants

Summary

Specifies the mouse highlight mode.

Syntax

typedef[v1_enum] enum MouseHighlightModeConstants 
{ 
   HIGHLIGHTMODE_TRANSLUCENT = 0, 
   HIGHLIGHTMODE_OPAQUE = 1, 
} MouseHighlightModeConstants; 

HIGHLIGHTMODE_TRANSLUCENT

The mouse highlight is translucent.

HIGHLIGHTMODE_OPAQUE

The mouse highlight is opaque.

UserEventsNotifyConstants

Summary

Determines which events will call the MouseEventsProc and/or KeyboardEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces.

Syntax

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; 

Members

USEREVENT_LBUTTONDOWN

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces if the left mouse button pressed.

USEREVENT_LBUTTONUP

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces if the left mouse button released.

USEREVENT_RBUTTONDOWN

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces if the right mouse button pressed.

USEREVENT_RBUTTONUP

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces if the left mouse button released.

USEREVENT_MOUSEMOVE

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces when the mouse moves.

USEREVENT_MOUSEWHEEL

Call MouseEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces when the mouse wheel is rotated.

USEREVENT_KEYDOWN

Call KeyboardEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces when a nonsystem key is pressed.

USEREVENT_KEYUP

Call KeyboardEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces when a nonsystem key is released.

USEREVENT_SYSKEYDOWN

Call KeyboardEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces 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 or ILMScrCapUserEventsCallback2 interfaces when the key that was pressed while the ALT key was held down released.

OutlineShapeConstants

Summary

Specifies the outline shape.

Syntax

typedef[v1_enum] enum OutlineShapeConstants 
{ 
   OUTLINESHAPE_RECTANGLE = 0x00, 
   OUTLINESHAPE_CORNER = 0x01, 
} OutlineShapeConstants; 

Members

OUTLINESHAPE_RECTANGLE

The outline shape is a rectangular shape.

OUTLINESHAPE_CORNER

The outline shape is a corner shape.

CaptureAlignmentConstants

Summary

Specifies the source capture alignments from the capture area.

Syntax

typedef[v1_enum] enum CaptureAlignmentConstants 
{ 
   CAPALIGNMENT_LEFT = 0x001, 
   CAPALIGNMENT_TOP = 0x002, 
   CAPALIGNMENT_RIGHT = 0x004, 
   CAPALIGNMENT_BOTTOM = 0x008, 
   CAPALIGNMENT_HCENTER = 0x010, 
   CAPALIGNMENT_VCENTER = 0x020, 
} CaptureAlignmentConstants; 

Members

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.

Properties

Type Name Description
CaptureSourceConstants CaptureSource Sets or gets the capture source type.
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_SELECTEDWINDOW.
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 Gets 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.
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 which events will call the NotifyCallbackProc of the ILMScrCapUserCallback or ILMScrCapUserCallback2 interfaces. For the possible values, refer to NotifyCallbackConstants.
SourceAreaChangeConstants OnSourceAreaChange Determines which 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.
SourceCloseConstants OnSourceClose Determines which action to take if the capture source is closed. This property has no effect if the capture source is set to full screen.
SourceMinimizeConstants OnSourceMinimize Determines which action to take if the capture source is minimized. This property has no effect if the capture source is set to full screen.
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 method 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.
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).
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 Displays a frame (outline) around the captured source.
OutlineShapeConstants OutlineShape Sets or gets a value that indicates the outline shape.
MouseHighlightConstants MouseHighlight Sets or gets a value that indicates the mouse highlight.
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 Changes the mouse highlight mode.
long UserEventsNotifyCallback Determines which events will call the MouseEventsProc and/or KeyboardEventsProc of the ILMScrCapUserEventsCallback or ILMScrCapUserEventsCallback2 interfaces. For possible values, refer to UserEventsNotifyConstants.
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).
long CaptureAlignment Sets or gets the source capture alignments from the capture area. It also has an effect on the panning and zooming process. For possible values, refer to CaptureAlignmentConstants.
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.
EffectShapeConstants OnRightBtnClkEffectShape Sets or gets a value that indicates the effect shape when the right button click.
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).
long MonitorSource Sets or gets the monitor source as a HMONITOR handle, this is useful in multiple monitors cases.
This property works in conjunction with CaptureSource property and requires it to be CAPTURE_FULL_SCREEN.
LONG_PTR SourceWindowHandle2

Methods

HRESULT SetUserEventsCallbackObject2(ILMScrCapUserEventsCallback2 *pCallbackObject, LONGLONG pUserData);

Description

Sets the callback object for the user events.

Parameters

pCallbackObject

A valid pointer to an ILMScrCapUserEventsCallback2 interface.

pUserData

LONGLONG value to pass a pointer for user-defined data required by the callback.

Comments

Pass NULL in pCallbackObject parameter to free the old callback object. For more information, refer to ILMScrCapUserEventsCallback2 interface.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT SetCallbackObject2(ILMScrCapUserCallback2 *pCallbackObject, LONGLONG pUserData);

Description

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

Parameters

pCallbackObject

A valid pointer to an ILMScrCapUserCallback2 interface.

pUserData

LONGLONG value to pass a pointer for user-defined data required by the callback.

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT PanToXY(long lXPos, long lYPos)

Description

Moves the capture area to the X and Y coordinates on the screen. This is valid only if the EnablePanning and EnableRegion properties are true.

Parameters

lXPos

The X Coordinates on the screen.

lYPos

The Y Coordinates on the screen.

Comments

The CaptureAlignment property determines the source capture alignments from the capture area.

Returns

Return Description
S_OK Successful.
E_UNEXPECTED Otherwise.

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

Description

Moves 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.

Parameters

lHwnd

The window handle to pan to it, or use one of the PanToWindowConstants values.

vbFollow

Determine if the region needs to follow the window when its position changes. Pass VARIANT_TRUE to follow the window, pass VARIANT_FALSE not to.

vbFit

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

HRESULT PanToCursor(VARIANT_BOOL vbFollow)

Description

Moves 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.

Parameters

vbFollow

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

HRESULT SetZoomStepsInfo(long lSteps, long lMinStepSize)

Description

Sets the zoom steps information to change the zoom level from the old to the new level with steps.

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.

Comments

To change the zoom level without any steps, pass 0 to lSteps parameter.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT GetZoomStepsInfo(long *plSteps, long *plMinStepSize)

Description

Gets the current zoom steps information.

Parameters

PlSteps

Pointer to receive the current zoom steps value.

plMinStepSize

Pointer to receive the current minimum step size in pixels.

Returns

Return Description
S_OK Successful.
S_E_POINTER Otherwise.

HRESULT SetPanStepsInfo(long lSteps, long lMinStepSteps)

Description

Sets the pan steps information to change the movement from the old to the new positions with steps.

Parameters

lSteps

The pan steps value between the old position and new position.

lMinStepSteps

The minimum step size in pixels. If the movement size will be less than lMinStepSize value, then the movement size will be lMinStepSize value.

Comments

To set the movement without any steps, pass 0 to lSteps parameter.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT GetPanStepsInfo(long *plSteps, long *plMinStepSize)

Description

Gets the current movement steps information.

Parameters

PlSteps

Pointer to receive the current pan steps value.

plMinStepSize

Pointer to receive the current minimum step size in pixels.

Returns

Return Description
S_OK Successful.
E_POINTER Otherwise.

HRESULT ResetToDefaults()

Description

Resets the screen capture options values to the default values.

Returns

S_OK.

HRESULT CaptureFrames(long lFramesNumber)

Description

Forces the number of frames (determined by lFramesNumber parameter) to be captured.

Comments

This method must be called in the manual mode; otherwise it will return a wrong state error.

Returns

Return Description
S_OK Successful.
VFW_E_WRONG_STATE Otherwise.

HRESULT RefreshSource()

Description

Refreshes the capture source coordinates before running.

Returns

S_OK.

HRESULT SelectRegionTool ()

Description

Activates the region selection tool for selecting a region of the current desktop.

Comments

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

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT SelectWindowTool ()

Description

Activates the window selection tool for selecting a window as the capture source for the filter.

Comments

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.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT SetCallbackObject(ILMScrCapUserCallback *pCallbackObject, long pUserData)

Description

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

Parameters

pCallbackObject

A valid pointer to an ILMScrCapUserCallback interface.

pUserData

Long value to pass a pointer for user-defined data required by the callback.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT ChangeSettings(VARIANT_BOOL bBegin)

Description

Sets the changes affecting the capture source.

Parameters

bBegin

Indicates whether the properties are being changed and the streaming paused, or the properties are being updated and streaming resumed. Possible values are:

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.

Comments

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

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT CancelSourceSelection()

Description

Cancels the region or window selection process.

Returns

Return Description
S_OK Successful.
S_FALSE Otherwise.

HRESULT SetUserEventsCallbackObject(ILMScrCapUserEventsCallback *pCallbackObject, long pUserData)

Description

Sets the callback object for the user events.

Parameters

pCallbackObject

A valid pointer to an ILMScrCapUserEventsCallback interface.

pUserData

Long value to pass a pointer for user-defined data required by the callback.

Comments

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

Returns

Return Description
S_OK Successful.
E_POINTER Otherwise.

HRESULT GetMonitorFromBounds(long lLeft, long lTop, long lRight, long lBottom, long *hMonitor)

Description

Gets a handle for the monitor that contains the provided boundaries according to the virtual screen resolution.

Parameters

lLeft

Left boundary.

lTop

Top boundary.

lRight

Right boundary.

lBottom

Bottom boundary.

hMonitor

A valid pointer to receive the handle of the monitor that contains the given boundaries.

Comments

If the returned value is 0, this means all screens must be selected to cover the given boundaries.

Returns

Return Description
S_OK Successful.
E_POINTER or E_FAIL Otherwise.
Help Version 22.0.2023.2.15
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Filters C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.