IDirect3DRMFrame::SetSceneBackgroundImage

HRESULT SetSceneBackgroundImage(LPDIRECT3DRMTEXTURE lpTexture);

Specifies a background image for a scene.

·Returns D3DRM_OK if successful, or an error otherwise. For a list of possible return codes, see Direct3D Retained-Mode Return Values.

lpTexture

Address of a Direct3DRMTexture object that will contain the new background scene.

If the image is a different size or color depth than the viewport, the image will first be scaled or converted to the correct depth. For best performance when animating the background, the image should be the same size and color depth. This enables the background to be rendered directly from the image memory without incurring any extra overhead.