这是界面导致屏幕捕获过滤器。
类型定义(v1_enum)枚举PanToWindowConstants
{
PANTO_WINDOWUNDERCURSOR = 1,
PANTO_ACTIVEWINDOW = 2
}PanToWindowConstants;
类型定义(v1_enum)枚举WindowSelectStatusConstants
{
WINDOW_SELECT_STATUS_UPDATE = 0,
WINDOW_SELECT_STATUS_SELECTED = 1,
WINDOW_SELECT_STATUS_CANCELED = 2,
}WindowSelectStatusConstants;
类型定义(v1_enum)枚举CaptureSourceConstants
{
CAPTURE_FULLSCREEN = 0,
CAPTURE_ACTIVEWINDOW = 1,
CAPTURE_ACTIVECLIENT = 2,
CAPTURE_SELECTEDWINDOW = 3
}CaptureSourceConstants;
类型定义(v1_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;
类型定义(v1_enum)枚举WindowCaptureOptionConstants
{
CAPTUREOPTION_VISIBLE_WINDOW = 0,
CAPTUREOPTION_ALL_WINDOW = 1,
}WindowCaptureOptionConstants;
类型定义(v1_enum)枚举NotifyCallbackConstants
{
NOTIFY_PRERUN_AREACHANGE = 0 x0000,
NOTIFY_CLOSE = 0 x0001,
NOTIFY_MINIMIZE = 0 x0002,
NOTIFY_AREACHANGE = 0 x0004,
NOTIFY_CAPWIDTH_EXCEEDED_LIMIT = 0 x0008,
NOTIFY_CAPHEIGHT_EXCEEDED_LIMIT = 0 x010,
}NotifyCallbackConstants;
类型定义(v1_enum)枚举SourceCloseConstants
{
CLOSE_STOP_CAPTURING = 0,
CLOSE_CONTINUE_FROM_LAST_POS = 1,
CLOSE_FILL_COLOR = 2
}SourceCloseConstants;
类型定义(v1_enum)枚举SourceMinimizeConstants
{
MINIMIZE_PAUSE_CAPTURING = 0,
MINIMIZE_STOP_CAPTURING = 1,
MINIMIZE_CONTINUE_FROM_LAST_POS = 2,
MINIMIZE_FILL_COLOR = 3
}SourceMinimizeConstants;
类型定义(v1_enum)枚举SourceAreaChangeConstants
{
AREACHANGE_CAPTURE_OTHER_WINDOWS = 0,
AREACHANGE_FILL_UNCOVERED_AREA = 1,
}SourceAreaChangeConstants;
类型定义(v1_enum)枚举EffectShapeConstants
{
EFFECTSHAPE_NON = 0,
EFFECTSHAPE_RINGS = 1,
EFFECTSHAPE_CIRCLE = 2,
EFFECTSHAPE_SUN = 3,
}EffectShapeConstants;
类型定义(v1_enum)枚举MouseHighlightConstants
{
MOUSEHIGHLIGHT_NON = 0,
MOUSEHIGHLIGHT_SQUARE = 1,
MOUSEHIGHLIGHT_RECTANGLE = 2,
MOUSEHIGHLIGHT_ROUNDEDRECTANGLE = 3,
MOUSEHIGHLIGHT_CIRCLE = 4,
MOUSEHIGHLIGHT_ELLIPSE = 5,
}MouseHighlightConstants;
类型定义(v1_enum)枚举MouseHighlightModeConstants
{
HIGHLIGHTMODE_TRANSLUCENT = 0,
HIGHLIGHTMODE_OPAQUE = 1,
}MouseHighlightModeConstants;
类型定义(v1_enum)枚举UserEventsNotifyConstants
{
USEREVENT_LBUTTONDOWN = 0 x001,
USEREVENT_LBUTTONUP = 0 x002,
USEREVENT_RBUTTONDOWN = 0 x004,
USEREVENT_RBUTTONUP = 0 x008,
USEREVENT_MOUSEMOVE = 0 x010,
USEREVENT_MOUSEWHEEL = 0 x020,
USEREVENT_KEYDOWN = 0 x040,
USEREVENT_KEYUP = 0 x080,
USEREVENT_SYSKEYDOWN = 0 x100,
USEREVENT_SYSKEYUP = 0 x200型
}UserEventsNotifyConstants;
类型定义(v1_enum)枚举OutlineShapeConstants
{
OUTLINESHAPE_RECTANGLE = 0 x00,
OUTLINESHAPE_CORNER = 0 x01,
}OutlineShapeConstants;
类型定义(v1_enum)枚举CaptureAlignmentConstants
{
CAPALIGNMENT_LEFT = 0 x001,
CAPALIGNMENT_TOP = 0 x002,
CAPALIGNMENT_RIGHT = 0 x004,
CAPALIGNMENT_BOTTOM = 0 x008,
CAPALIGNMENT_HCENTER = 0 x010,
CAPALIGNMENT_VCENTER = 0 x020,
}CaptureAlignmentConstants;
类型 |
的名字 |
描述 |
CaptureSourceConstants |
CaptureSource |
设置或获取捕获源类型。可能的值是: |
长 |
SourceWindowHandle |
设置或获取来源的窗口句柄。改变这个属性将自动设置CaptureSource属性CAPTURE_SELECTEDWINDOW这个接口。 |
浮动 |
CaptureFrameRate |
集或帧每秒的帧率。过滤器将试图捕捉尽可能以这种速度。可能的值的范围从0.1到30.0帧每秒。 |
VARIANT_BOOL |
ConnectionStatus |
滤波器输出的连接状态。可能的值是: |
CursorIconConstants |
CursorIcon |
设置或获取光标图标。可能的值是: CURSOR_ARROW, 如果值是CURSOR_ACTUAL,那么实际的光标在屏幕上图标将被捕获。 如果CURSOR_CUSTOM值,则设置自定义光标图标使用这个接口的CustomCursor财产将被捕获。 |
长 |
CustomCursor |
设置或获取自定义光标处理。自定义光标将只有在使用这个接口的CursorIcon属性设置为CURSOR_CUSTOM。 |
VARIANT_BOOL |
EnableRegion |
启用或禁用该地区使用坐标。该地区将仅限于当前捕获源的尺寸。 |
长 |
FillColor |
设置填充颜色或者被用来填充的区域在特定条件下的视频。这个属性接受/检索COLORREF价值。的更多信息,请参阅OnSourceClose属性,OnSourceMinimize财产和OnSourceAreaChange这个接口的属性。 |
长 |
NotifyCallback |
决定哪些事件将调用的NotifyCallbackProc ILMScrCapUserCallback接口。可能的值是: NOTIFY_PRERUN_AREACHANGE:叫NotifyCallbackProc ILMScrCapUserCallback接口如果捕获源区域的变化而过滤不在运行状态。一旦发送通知过滤器运行。 NOTIFY_CLOSE:叫NotifyCallbackProc ILMScrCapUserCallback接口捕捉源时关闭。 NOTIFY_MINIMIZE:叫NotifyCallbackProc ILMScrCapUserCallback接口捕捉源时最小化。 NOTIFY_AREACHANGE:叫NotifyCallbackProc ILMScrCapUserCallback接口的捕获区域时发生了变化。 NOTIFY_CAPWIDTH_EXCEEDED_LIMIT:叫NotifyCallbackProc ILMScrCapUserCallback接口的使用选择工具时,选择区域的宽度超过了LowerWidthLimit或UpperWidthLimit值。 NOTIFY_CAPHEIGHT_EXCEEDED_LIMIT:叫NotifyCallbackProc ILMScrCapUserCallback接口的使用选择工具时,选择区域的高度超过了LowerHeightLimit或UpperHeightLimit值。 这些值也可以组合使用逻辑或。 |
SourceAreaChangeConstants |
OnSourceAreaChange |
确定哪些操作如果捕获源区域的大小或捕获的可见区域源被其他窗口覆盖。这个属性没有影响,如果捕捉源设置为全屏。可能的值是: AREACHANGE_CAPTURE_OTHER_WINDOWS:捕捉下的内容大小或/和转换区。 AREACHANGE_FILL_UNCOVERED_AREA:填满大小或/和覆盖区域中指定的颜色FillColor这个接口的属性。 |
SourceCloseConstants |
OnSourceClose |
确定哪些操作如果捕获源是关闭的。这个属性没有影响,如果捕捉源设置为全屏。可能的值是: |
SourceMinimizeConstants |
OnSourceMinimize |
确定哪些操作如果捕捉源最小化。这个属性没有影响,如果捕捉源设置为全屏。可能的值是: |
长 |
RegionBottom |
集或者底部边界的地区。值范围从RegionTop SourceHeight财产属性+ 1。 |
长 |
RegionLeft |
设置或获取的左边界地区。范围从0到RegionRight属性的值。 |
长 |
RegionRight |
设置或获取正确的边界地区。值范围从RegionLeft SourceWidth财产属性+ 1。 |
长 |
RegionTop |
设置或获取最高的边界地区。范围从0到RegionBottom属性的值。 |
VARIANT_BOOL |
ShowCrossLines |
显示或隐藏交叉线时光标SelectRegionTool方法被使用。可能的值是: |
VARIANT_BOOL |
ShowCursor |
显示或隐藏鼠标捕获流。可能的值是: |
VARIANT_BOOL |
ShowPanWindow |
显示或隐藏盘窗口当SelectRegionTool方法被使用。潘窗口提供高达10倍的放大。使用+和键来放大和缩小。批评的领域是鼠标光标下的面积。 |
VARIANT_BOOL |
ShowWHInfo |
显示或隐藏区域宽度和高度信息,同时拖动鼠标选择区域,当SelectRegionTool方法被使用。附近的宽度和高度信息显示游标。 |
VARIANT_BOOL |
ShowXYPosInfo |
显示或隐藏的X和Y坐标,拖动鼠标选择一个地区SelectRegionTool方法时使用。附近的X和Y坐标信息显示游标。 |
长 |
SourceHeight |
(只读)检索的实际高度像素捕获区域。 |
长 |
SourceWidth |
(只读)检索的实际宽度像素捕获区域。 |
VARIANT_BOOL |
TrackWindow |
启用或禁用跟踪窗口的选择。可能的值是: 这个属性没有影响,如果捕捉源设置为全屏。 |
WindowCaptureOptionConstants |
WindowCaptureOption |
集或获得一个值,指示如何捕获的窗口。可能的值是: 这个属性没有影响,如果捕捉源设置为全屏。 |
VARIANT_BOOL |
ManualMode |
启用或禁用手动拍摄模式。在手动拍摄模式,框架推动下游用户请求(如果CaptureFrames没有帧将被捕获方法不叫)。 |
EffectShapeConstants |
OnRightBtnClkEffectShape |
集或得到一个值,指示正确的按钮单击时形状的影响。可能的值是: EFFECTSHAPE_NON:不要执行任何效果。 EFFECTSHAPE_RINGS:当鼠标点击显示环的影响。 EFFECTSHAPE_CIRCLE:鼠标点击时显示循环效应。 EFFECTSHAPE_SUN:显示当鼠标点击太阳的影响。 |
长 |
OnLeftBtnClkEffectColor |
设置或获取鼠标左键点击颜色影响形状。这个属性接受/检索COLORREF价值。 |
长 |
OnRightBtnClkEffectColor |
设置或获取鼠标右键点击颜色影响形状。这个属性接受/检索COLORREF价值。 |
长 |
OnLeftBtnClkEffectSize |
设置或获取鼠标左键点击时形状效应大小。 |
长 |
OnRightBtnClkEffectSize |
设置或获取当鼠标右键单击形状效应大小。 |
VARIANT_BOOL |
EnableOutline |
显示一个框架(大纲)在捕获的来源。 |
OutlineShapeConstants |
OutlineShape |
集或得到一个值,表示轮廓形状。可能的值是: OUTLINESHAPE_RECTANGLE:外形轮廓是一个长方形的形状。 OUTLINESHAPE_CORNER:外形轮廓形状是一个角落。 |
MouseHighlightConstants |
MouseHighlight |
集或获得一个值,指示鼠标高亮显示。可能的值是: MOUSEHIGHLIGHT_NON:不要执行任何鼠标形状的亮点。 MOUSEHIGHLIGHT_SQUARE:显示一个正方形形状突出鼠标。 MOUSEHIGHLIGHT_RECTANGLE:显示一个矩形突出鼠标。 MOUSEHIGHLIGHT_ROUNDEDRECTANGLE:显示一个圆角矩形的形状突出鼠标。 MOUSEHIGHLIGHT_CIRCLE:显示一个圆形突出鼠标。 MOUSEHIGHLIGHT_ELLIPSE:显示一个椭圆形状突出鼠标。 |
长 |
MouseHighlightSize |
设置或获取鼠标突出大小。这个属性接受/检索COLORREF价值。 |
长 |
MouseHighlightColor |
设置或获取鼠标高亮颜色。这个属性接受/检索COLORREF价值。 |
MouseHighlightModeConstants |
MouseHighlightMode |
更改鼠标高亮显示模式。可能的值是: HIGHLIGHTMODE_TRANSLUCENT:鼠标突出是半透明的。 HIGHLIGHTMODE_OPAQUE:鼠标强调的是不透明的。 |
长 |
UserEventsNotifyCallback |
决定哪些事件将调用MouseEventsProc和/或KeyboardEventsProc ILMScrCapUserEventsCallback界面。可能的值是: USEREVENT_LBUTTONDOWN:叫MouseEventsProc ILMScrCapUserEventsCallback接口的鼠标左键按下。 USEREVENT_LBUTTONUP: ILMScrCapUserEventsCallback接口的调用MouseEventsProc如果鼠标左键释放。 USEREVENT_RBUTTONDOWN: ILMScrCapUserEventsCallback接口的调用MouseEventsProc如果鼠标右键按下。 USEREVENT_RBUTTONUP: ILMScrCapUserEventsCallback接口的调用MouseEventsProc如果鼠标左键释放。 USEREVENT_MOUSEMOVE:叫MouseEventsProc ILMScrCapUserEventsCallback接口的鼠标移动的时候。 USEREVENT_MOUSEWHEEL:叫MouseEventsProc ILMScrCapUserEventsCallback接口的鼠标滚轮时旋转。 USEREVENT_KEYDOWN: ILMScrCapUserEventsCallback接口的调用KeyboardEventsProc nonsystem键被按下时。 USEREVENT_KEYUP ILMScrCapUserEventsCallback接口的调用KeyboardEventsProc nonsystem关键时释放。 USEREVENT_SYSKEYDOWN:叫KeyboardEventsProc ILMScrCapUserEventsCallback接口的F10键按下时(激活菜单栏)或压低了ALT键然后按另一个键。 USEREVENT_SYSKEYUP:叫KeyboardEventsProc ILMScrCapUserEventsCallback界面时按下的键ALT键被释放。 |
VARIANT_BOOL |
ManualMode |
启用或禁用手动拍摄模式。在手动拍摄模式,框架推动下游用户请求(如果CaptureFrames没有帧将被捕获方法不叫)。 |
长 |
CaptureAlignment |
设置或获取源捕获捕获面积比对。它也有一个平移和缩放的影响过程。可能的值是: CAPALIGNMENT_LEFT:源捕获将从左边。 CAPALIGNMENT_TOP:源捕获将从顶部。 CAPALIGNMENT_RIGHT:源捕获将从右边。 CAPALIGNMENT_BOTTOM:源捕获将从底部。 CAPALIGNMENT_HCENTER:源捕获将从水平居中。 CAPALIGNMENT_VCENTER:源捕获将从垂直的中心。 |
长 |
OutlineColor |
设置或获取轮廓形状的颜色。这个属性接受/检索COLORREF价值。 |
长 |
LowerWidthLimit |
设置或获取最低区域宽度,可以选择当使用SelectRegionTool方法。 |
长 |
UpperWidthLimit |
设置或获取最大区域宽度,可以选择当使用SelectRegionTool方法。 |
长 |
LowerHeightLimit |
设置或获取最小区域高度可以选择当使用SelectRegionTool方法。 |
长 |
UpperHeightLimit |
设置或获取最大地区高度可以选择当使用SelectRegionTool方法。 |
长 |
RgnSelToolStepSizeX |
设置或获取X的步长选择过程在使用SelectRegionTool方法。(e。如果这个值是2,选择X步骤将2×2像素)。 |
长 |
RgnSelToolStepSizeY |
设置或获取Y的步长选择过程在使用SelectRegionTool方法。(e。如果这个值是2,选择Y步骤将2×2像素)。 |
长 |
RgnSelToolWarningColor |
设置或获取颜色选择工具警告。 |
VARIANT_BOOL |
RgnSelToolLockSelOnLimit |
启用或禁用锁选择的区域宽度和/或高度达到极限。如果这是VARIANT_TRUE,选择将被锁定。如果这是VARIANT_FALSE VARIANT_TRUE ShowWHInfo属性,宽度/高度信息对话框将与RgnSelToolWarningColor改变颜色。 |
EffectShapeConstants |
OnLeftBtnClkEffectShape |
集或得到一个值,表示左按钮单击时形状的影响。可能的值是: EFFECTSHAPE_NON:鼠标点击时不执行任何效果。 EFFECTSHAPE_RINGS:当鼠标点击显示环的影响。 EFFECTSHAPE_CIRCLE:鼠标点击时显示循环效应。 EFFECTSHAPE_SUN:显示当鼠标点击太阳的影响。 |
EffectShapeConstants |
OnRightBtnClkEffectShape |
集或得到一个值,指示正确的按钮单击时形状的影响。可能的值是: EFFECTSHAPE_NON:不要执行任何效果。 EFFECTSHAPE_RINGS:当鼠标点击显示环的影响。 EFFECTSHAPE_CIRCLE:鼠标点击时显示循环效应。 EFFECTSHAPE_SUN:显示当鼠标点击太阳的影响。 |
长 |
OnLeftBtnClkEffectColor |
设置或获取鼠标左键点击颜色影响形状。这个属性接受/检索COLORREF价值。 |
长 |
OnRightBtnClkEffectColor |
设置或获取鼠标右键点击颜色影响形状。这个属性接受/检索COLORREF价值。 |
长 |
OnLeftBtnClkEffectSize |
设置或获取鼠标左键点击时形状效应大小。 |
长 |
OnRightBtnClkEffectSize |
设置或获取当鼠标右键单击形状效应大小。 |
VARIANT_BOOL |
EnablePanning |
启用或禁用鼠标平移。如果该值为VARIANT_TRUE那么它将覆盖地区和窗口选项和捕捉源将鼠标周围地区,可以确定使用PanningWidth和PanningHeight属性。 |
长 |
ZoomFactor |
改变缩放因子。可能的值10至800。100没有造成变焦(正常大小)。 |
长 | MonitorSource | 设置或获取监控源HMONITOR处理,这是非常有用的在多个监控情况。 这个属性是结合CaptureSource CAPTURE_FULL_SCREEN财产和需要。 |
LONG_PTR | SourceWindowHandle2 |
lXPos |
屏幕上的X坐标。 |
lYPos |
Y坐标在屏幕上。 |
捕获区域移动到屏幕上的X和Y坐标。这是有效的只有EnablePanning EnableRegion属性是正确的。CaptureAlignment属性决定了源捕获捕获面积比对。
S_OK如果成功,否则E_UNEXPECTED。
lHwnd |
窗口句柄锅,或者使用下列值之一: PANTO_WINDOWUNDERCURSOR:锅的窗口在用户光标。 PANTO_ACTIVEWINDOW:锅里活跃的窗口。 |
vbFollow |
确定该地区需要遵循其位置变化时的窗口。VARIANT_TRUE遵循窗口,传球VARIANT_FALSE不是小孩。 |
vbFit |
确定该地区需要合适的窗口。VARIANT_TRUE以适应窗口,传球VARIANT_FALSE不这么做。 |
移动通过窗口句柄的捕获区域坐标。这是有效的只有EnablePanning EnableRegion属性是正确的。CaptureAlignment属性决定了源捕获捕获面积比对。
vbFollow |
如果这是VARIANT_TRUE,该地区将跟踪光标移动。 |
捕获区域移动到光标位置。这是有效的只有EnablePanning EnableRegion属性是正确的。CaptureAlignment属性决定了源捕获捕获面积比对。
lSteps |
老缩放级别之间的变焦步骤价值和新的缩放级别。 |
lMinStepSize |
最小的步骤大小(以像素为单位)。如果增加/减少的大小要小于lMinStepSize值,然后将lMinStepSize增加/减少大小的值。 |
设置缩放步骤信息更改缩放级别从旧到新的水平与步骤。改变缩放级别没有任何步骤,通过0 lSteps参数。
S_OK如果成功,否则S_FALSE。
PlSteps |
指针接收当前缩放值的步骤。 |
plMinStepSize |
指针接收当前像素最小步长。 |
获取当前缩放步骤的信息。
S_OK如果成功,否则S_E_POINTER。
lSteps |
锅步骤价值之间的位置和新老位置。 |
lMinStepSteps |
最小的步骤大小(以像素为单位)。如果运动规模将小于lMinStepSize价值,那么运动大小将lMinStepSize价值。 |
套锅的步骤信息改变运动从旧到新的位置与步骤。设置运动没有任何步骤,通过0 lSteps参数。
S_OK如果成功,否则S_FALSE。
PlSteps |
值指针接收当前盘步骤。 |
plMinStepSize |
指针接收当前像素最小步长。 |
获取当前运动信息的步骤。
S_OK如果成功,否则E_POINTER。
重置的屏幕捕获选项值的默认值。
S_OK
使用CaptureFrames方法强迫的帧数(由lFramesNumber参数)。调用这个方法必须在手动模式;否则它将返回一个错误状态错误。
S_OK如果成功,否则VFW_E_WRONG_STATE。
刷新之前捕获源坐标运行。
S_OK价值。
激活的区域选择工具选择一个地区当前的桌面。选择一个地区,按住鼠标左键并拖动鼠标,直到所需的地区了。释放鼠标按钮来完成选择。取消选择过程,按ESC键。选项为拖动鼠标时显示信息。
的更多信息,请参阅下面的属性界面中列出的属性表上面:
EnableRegion财产
RegionLeft财产
RegionTop财产
RegionRight财产
RegionBottom财产
ShowPanWindow财产
ShowCrossLines财产
ShowXYPosInfo财产
ShowWHInfo财产
S_OK如果成功,否则S_FALSE。
激活窗口选择工具选择一个窗口作为过滤器捕获源。选择光标下的窗口,按下鼠标左键。取消窗口选择过程,按ESC键。选项所提供的几个属性的界面,拖动鼠标时显示信息。
S_OK如果成功,否则S_FALSE。
pCallbackObject |
一个有效的指针指向一个ILMScrCapUserCallback接口。 |
pUserData |
长值通过回调所需的用户定义的数据的指针。 |
设置回调对象的屏幕捕获过滤器。有关更多信息,请参考ILMScrCapUserCallback接口。
S_OK如果成功,否则S_FALSE。
bBegin | 显示属性被改变,是否流停顿了一下,或属性被更新和流恢复。 | |
价值 | 意义 | |
VARIANT_TRUE | 属性被更改和流媒体已经暂停。 | |
VARIANT_FALSE | 属性被更新和流媒体已经恢复。 |
集的变化影响捕获源。你之前和之后必须调用这个方法设置以下属性或调用下面的方法ILMScrCap接口:
CaptureSource财产
SourceWindowHandle财产
RegionLeft财产
RegionTop财产
RegionRight财产
RegionBottom财产
SelectRegionTool方法
SelectWindowTool方法
S_OK如果成功,否则S_FALSE。
取消该地区或窗口选择过程。
S_OK如果连接,否则S_FALSE。
pCallbackObject |
一个有效的指针指向一个ILMScrCapUserEventsCallback接口。 |
pUserData |
长值通过回调所需的用户定义的数据的指针。 |
为用户设置回调对象的事件。通过零pCallbackObject参数自由老回调对象。有关更多信息,请参考ILMScrCapUserEventsCallback接口。
S_OK如果成功,否则E_POINTER。
lLeft |
左边界。 |
lTop |
顶部边界。 |
lRight |
正确的边界。 |
lBottom |
底部边界。 |
hMonitor |
有效的指针接收包含给定的边界处理的监控。 |
被监控的处理包含提供边界根据虚拟屏幕分辨率。
如果返回值为0,这意味着所有屏幕必须选择覆盖给定的边界。
S_OK如果成功;否则,E_POINTER或E_FAIL。