This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9 and obsolete as of Internet Explorer 10.
Sets the surface modifier background surface.
HRESULT SetBackground( IDXSurface *pSurface );
- [in] Pointer to the surface to use as a background surface; this parameter can be NULL to indicate no background surface.
Returns an HRESULT value that depends on the implementation of the interface.
If pSurface is NULL, the current bounds of the surface are not changed. If there is a fill color, the Surface Modifier uses the fill color as the background color.
If pSurface is not NULL, the Surface Modifier uses the size of the background surface as its bounds, overriding any previous call to IDXSurfaceModifier::SetBounds. Subsequent calls to IDXSurfaceModifier::SetBounds must specify a bounds equal to the bounds of the background surface or else an error results. For more information about the relationship of various properties of Surface Modifiers, see the IDXSurfaceModifier interface.