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.
Retrieves a pointer to the DXSurface used as a foreground.
HRESULT GetForeground( IDXSurface **ppSurface, BOOL *pbTile, POINT *pOrigin );
- [out] Optional address of a pointer to the interface through which to access the foreground surface.
- [out] Optional pointer to a BOOL that indicates whether the foreground surface is tiled. If TRUE, the surface is tiled over the background. Otherwise, the value is FALSE.
- [out] Optional pointer to the coordinates currently used as the origin.
Returns an HRESULT value that depends on the implementation of the interface.
All parameters to this method are optional. If you do not need to retrieve a particular piece of data, pass a NULL pointer for that argument.
If there is no foreground surface, this method returns S_OK, but ppSurface is set to NULL. When a pointer to the interface for the foreground surface is retrieved, the method automatically calls AddRef on the interface. The client is responsible for calling Release on the interface when it is no longer needed.