surface.c File Reference

#include "d3d8_private.h"

Include dependency graph for surface.c:

Go to the source code of this file.

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (d3d8)
static struct d3d8_surface *	impl_from_IDirect3DSurface8 (IDirect3DSurface8 *iface)
static HRESULT WINAPI	d3d8_surface_QueryInterface (IDirect3DSurface8 *iface, REFIID riid, void **out)
static ULONG WINAPI	d3d8_surface_AddRef (IDirect3DSurface8 *iface)
static ULONG WINAPI	d3d8_surface_Release (IDirect3DSurface8 *iface)
static HRESULT WINAPI	d3d8_surface_GetDevice (IDirect3DSurface8 *iface, IDirect3DDevice8 **device)
static HRESULT WINAPI	d3d8_surface_SetPrivateData (IDirect3DSurface8 *iface, REFGUID guid, const void *data, DWORD data_size, DWORD flags)
static HRESULT WINAPI	d3d8_surface_GetPrivateData (IDirect3DSurface8 *iface, REFGUID guid, void *data, DWORD *data_size)
static HRESULT WINAPI	d3d8_surface_FreePrivateData (IDirect3DSurface8 *iface, REFGUID guid)
static HRESULT WINAPI	d3d8_surface_GetContainer (IDirect3DSurface8 *iface, REFIID riid, void **container)
static HRESULT WINAPI	d3d8_surface_GetDesc (IDirect3DSurface8 *iface, D3DSURFACE_DESC *desc)
static HRESULT WINAPI	d3d8_surface_LockRect (IDirect3DSurface8 *iface, D3DLOCKED_RECT *locked_rect, const RECT *rect, DWORD flags)
static HRESULT WINAPI	d3d8_surface_UnlockRect (IDirect3DSurface8 *iface)
static void STDMETHODCALLTYPE	surface_wined3d_object_destroyed (void *parent)
struct d3d8_surface *	d3d8_surface_create (struct wined3d_texture *wined3d_texture, unsigned int sub_resource_idx, IUnknown *container)
static void STDMETHODCALLTYPE	view_wined3d_object_destroyed (void *parent)
struct d3d8_device *	d3d8_surface_get_device (const struct d3d8_surface *surface)
struct wined3d_rendertarget_view *	d3d8_surface_acquire_rendertarget_view (struct d3d8_surface *surface)
void	d3d8_surface_release_rendertarget_view (struct d3d8_surface *surface, struct wined3d_rendertarget_view *rtv)
struct d3d8_surface *	unsafe_impl_from_IDirect3DSurface8 (IDirect3DSurface8 *iface)

Variables
static const IDirect3DSurface8Vtbl	d3d8_surface_vtbl
static const struct wined3d_parent_ops	d3d8_surface_wined3d_parent_ops
static const struct wined3d_parent_ops	d3d8_view_wined3d_parent_ops

Function Documentation

d3d8_surface_acquire_rendertarget_view()

struct wined3d_rendertarget_view * d3d8_surface_acquire_rendertarget_view

(

struct d3d8_surface *

surface

)

Definition at line 379 of file surface.c.

{
    HRESULT hr;
 
    /* The surface reference count can be equal to 0 when this function is
     * called. In order to properly manage the render target view reference
     * count, we temporarily increment the surface reference count. */
    d3d8_surface_AddRef(&surface->IDirect3DSurface8_iface);
 
    if (surface->wined3d_rtv)
        return surface->wined3d_rtv;
 
    if (FAILED(hr = wined3d_rendertarget_view_create_from_sub_resource(surface->wined3d_texture,
            surface->sub_resource_idx, surface, &d3d8_view_wined3d_parent_ops, &surface->wined3d_rtv)))
    {
        ERR("Failed to create rendertarget view, hr %#lx.\n", hr);
        d3d8_surface_Release(&surface->IDirect3DSurface8_iface);
        return NULL;
    }
 
    if (surface->texture)
        list_add_head(&surface->texture->rtv_list, &surface->rtv_entry);
 
    return surface->wined3d_rtv;
}

Referenced by d3d8_device_SetRenderTarget().

d3d8_surface_AddRef()

static ULONG WINAPI d3d8_surface_AddRef ( IDirect3DSurface8 *  iface )

static

Definition at line 49 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    ULONG refcount;
 
    TRACE("iface %p.\n", iface);
 
    if (surface->texture)
    {
        TRACE("Forwarding to %p.\n", surface->texture);
        return IDirect3DBaseTexture8_AddRef(&surface->texture->IDirect3DBaseTexture8_iface);
    }
 
    refcount = InterlockedIncrement(&surface->resource.refcount);
    TRACE("%p increasing refcount to %lu.\n", iface, refcount);
 
    if (refcount == 1)
    {
        if (surface->parent_device)
            IDirect3DDevice8_AddRef(surface->parent_device);
        if (surface->wined3d_rtv)
            wined3d_rendertarget_view_incref(surface->wined3d_rtv);
        wined3d_texture_incref(surface->wined3d_texture);
        if (surface->swapchain)
            wined3d_swapchain_incref(surface->swapchain);
    }
 
    return refcount;
}

Referenced by d3d8_surface_acquire_rendertarget_view().

d3d8_surface_create()

struct d3d8_surface * d3d8_surface_create	(	struct wined3d_texture *	wined3d_texture,
		unsigned int	sub_resource_idx,
		IUnknown *	container
	)

Definition at line 318 of file surface.c.

{
    IDirect3DBaseTexture8 *texture;
    struct d3d8_surface *surface;
 
    if (!(surface = calloc(1, sizeof(*surface))))
        return NULL;
 
    surface->IDirect3DSurface8_iface.lpVtbl = &d3d8_surface_vtbl;
    d3d8_resource_init(&surface->resource);
    surface->resource.refcount = 0;
    list_init(&surface->rtv_entry);
    surface->container = container;
    surface->wined3d_texture = wined3d_texture;
    surface->sub_resource_idx = sub_resource_idx;
    surface->swapchain = wined3d_texture_get_swapchain(wined3d_texture);
 
    if (surface->container && SUCCEEDED(IUnknown_QueryInterface(surface->container,
            &IID_IDirect3DBaseTexture8, (void **)&texture)))
    {
        surface->texture = unsafe_impl_from_IDirect3DBaseTexture8(texture);
        IDirect3DBaseTexture8_Release(texture);
    }
 
    wined3d_texture_set_sub_resource_parent(wined3d_texture, sub_resource_idx,
            surface, &d3d8_surface_wined3d_parent_ops);
 
    TRACE("Created surface %p.\n", surface);
    return surface;
}

Referenced by d3d8_device_create_surface(), d3d8_device_CreateCubeTexture(), d3d8_device_CreateTexture(), d3d8_device_Reset(), and d3d8_swapchain_create().

d3d8_surface_FreePrivateData()

static HRESULT WINAPI d3d8_surface_FreePrivateData ( IDirect3DSurface8 *  iface, REFGUID  guid  )

static

Definition at line 157 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    TRACE("iface %p, guid %s.\n", iface, debugstr_guid(guid));
 
    return d3d8_resource_free_private_data(&surface->resource, guid);
}

d3d8_surface_get_device()

struct d3d8_device * d3d8_surface_get_device

(

const struct d3d8_surface *

surface

)

Definition at line 372 of file surface.c.

{
    IDirect3DDevice8 *device;
    device = surface->texture ? &surface->texture->parent_device->IDirect3DDevice8_iface : surface->parent_device;
    return impl_from_IDirect3DDevice8(device);
}

Referenced by d3d8_device_SetRenderTarget().

d3d8_surface_GetContainer()

static HRESULT WINAPI d3d8_surface_GetContainer ( IDirect3DSurface8 *  iface, REFIID  riid, void **  container  )

static

Definition at line 165 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    HRESULT hr;
 
    TRACE("iface %p, riid %s, container %p.\n", iface, debugstr_guid(riid), container);
 
    if (!surface->container)
        return E_NOINTERFACE;
 
    hr = IUnknown_QueryInterface(surface->container, riid, container);
 
    TRACE("Returning %p.\n", *container);
 
    return hr;
}

d3d8_surface_GetDesc()

static HRESULT WINAPI d3d8_surface_GetDesc ( IDirect3DSurface8 *  iface, D3DSURFACE_DESC *  desc  )

static

Definition at line 182 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    struct wined3d_sub_resource_desc wined3d_desc;
 
    TRACE("iface %p, desc %p.\n", iface, desc);
 
    wined3d_mutex_lock();
    wined3d_texture_get_sub_resource_desc(surface->wined3d_texture, surface->sub_resource_idx, &wined3d_desc);
    wined3d_mutex_unlock();
 
    desc->Format = d3dformat_from_wined3dformat(wined3d_desc.format);
    desc->Type = D3DRTYPE_SURFACE;
    desc->Usage = d3dusage_from_wined3dusage(wined3d_desc.usage, wined3d_desc.bind_flags);
    desc->Pool = d3dpool_from_wined3daccess(wined3d_desc.access, wined3d_desc.usage);
    desc->Size = wined3d_desc.size;
    desc->MultiSampleType = d3dmultisample_type_from_wined3d(wined3d_desc.multisample_type);
    desc->Width = wined3d_desc.width;
    desc->Height = wined3d_desc.height;
 
    return D3D_OK;
}

d3d8_surface_GetDevice()

static HRESULT WINAPI d3d8_surface_GetDevice ( IDirect3DSurface8 *  iface, IDirect3DDevice8 **  device  )

static

Definition at line 120 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
 
    TRACE("iface %p, device %p.\n", iface, device);
 
    if (surface->texture)
        return IDirect3DBaseTexture8_GetDevice(&surface->texture->IDirect3DBaseTexture8_iface, device);
 
    *device = surface->parent_device;
    IDirect3DDevice8_AddRef(*device);
 
    TRACE("Returning device %p.\n", *device);
 
    return D3D_OK;
}

d3d8_surface_GetPrivateData()

static HRESULT WINAPI d3d8_surface_GetPrivateData ( IDirect3DSurface8 *  iface, REFGUID  guid, void *  data, DWORD *  data_size  )

static

Definition at line 147 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    TRACE("iface %p, guid %s, data %p, data_size %p.\n",
            iface, debugstr_guid(guid), data, data_size);
 
    return d3d8_resource_get_private_data(&surface->resource, guid, data, data_size);
}

d3d8_surface_LockRect()

static HRESULT WINAPI d3d8_surface_LockRect ( IDirect3DSurface8 *  iface, D3DLOCKED_RECT *  locked_rect, const RECT *  rect, DWORD  flags  )

static

Definition at line 205 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    struct wined3d_box box;
    struct wined3d_map_desc map_desc;
    HRESULT hr;
    D3DRESOURCETYPE type;
 
    TRACE("iface %p, locked_rect %p, rect %s, flags %#lx.\n",
            iface, locked_rect, wine_dbgstr_rect(rect), flags);
 
    wined3d_mutex_lock();
 
    if (surface->texture)
        type = IDirect3DBaseTexture8_GetType(&surface->texture->IDirect3DBaseTexture8_iface);
    else
        type = D3DRTYPE_SURFACE;
 
    if (rect)
    {
        D3DSURFACE_DESC desc;
        IDirect3DSurface8_GetDesc(iface, &desc);
 
        if (type != D3DRTYPE_TEXTURE
                && ((rect->left < 0)
                || (rect->top < 0)
                || (rect->left >= rect->right)
                || (rect->top >= rect->bottom)
                || (rect->right > desc.Width)
                || (rect->bottom > desc.Height)))
        {
            WARN("Trying to lock an invalid rectangle, returning D3DERR_INVALIDCALL\n");
            wined3d_mutex_unlock();
 
            locked_rect->Pitch = 0;
            locked_rect->pBits = NULL;
            return D3DERR_INVALIDCALL;
        }
        wined3d_box_set(&box, rect->left, rect->top, rect->right, rect->bottom, 0, 1);
    }
 
    hr = wined3d_resource_map(wined3d_texture_get_resource(surface->wined3d_texture), surface->sub_resource_idx,
            &map_desc, rect ? &box : NULL, wined3dmapflags_from_d3dmapflags(flags, 0));
    wined3d_mutex_unlock();
 
    if (SUCCEEDED(hr))
    {
        locked_rect->Pitch = map_desc.row_pitch;
        locked_rect->pBits = map_desc.data;
    }
    else if (type != D3DRTYPE_TEXTURE)
    {
        locked_rect->Pitch = 0;
        locked_rect->pBits = NULL;
    }
 
    if (hr == E_INVALIDARG)
        return D3DERR_INVALIDCALL;
    return hr;
}

d3d8_surface_QueryInterface()

static HRESULT WINAPI d3d8_surface_QueryInterface ( IDirect3DSurface8 *  iface, REFIID  riid, void **  out  )

static

Definition at line 30 of file surface.c.

{
    TRACE("iface %p, riid %s, out %p.\n", iface, debugstr_guid(riid), out);
 
    if (IsEqualGUID(riid, &IID_IDirect3DSurface8)
            || IsEqualGUID(riid, &IID_IDirect3DResource8)
            || IsEqualGUID(riid, &IID_IUnknown))
    {
        IDirect3DSurface8_AddRef(iface);
        *out = iface;
        return S_OK;
    }
 
    WARN("%s not implemented, returning E_NOINTERFACE.\n", debugstr_guid(riid));
 
    *out = NULL;
    return E_NOINTERFACE;
}

d3d8_surface_Release()

static ULONG WINAPI d3d8_surface_Release ( IDirect3DSurface8 *  iface )

static

Definition at line 79 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    ULONG refcount;
 
    TRACE("iface %p.\n", iface);
 
    if (surface->texture)
    {
        TRACE("Forwarding to %p.\n", surface->texture);
        return IDirect3DBaseTexture8_Release(&surface->texture->IDirect3DBaseTexture8_iface);
    }
 
    if (!surface->resource.refcount)
    {
        WARN("Surface does not have any references.\n");
        return 0;
    }
 
    refcount = InterlockedDecrement(&surface->resource.refcount);
    TRACE("%p decreasing refcount to %lu.\n", iface, refcount);
 
    if (!refcount)
    {
        IDirect3DDevice8 *parent_device = surface->parent_device;
 
        if (surface->wined3d_rtv)
            wined3d_rendertarget_view_decref(surface->wined3d_rtv);
        if (surface->swapchain)
           wined3d_swapchain_decref(surface->swapchain);
        /* Releasing the texture may free the d3d8 object, so do not access it
         * after releasing the texture. */
        wined3d_texture_decref(surface->wined3d_texture);
 
        if (parent_device)
            IDirect3DDevice8_Release(parent_device);
    }
 
    return refcount;
}

Referenced by d3d8_surface_acquire_rendertarget_view(), and d3d8_surface_release_rendertarget_view().

d3d8_surface_release_rendertarget_view()

void d3d8_surface_release_rendertarget_view	(	struct d3d8_surface *	surface,
		struct wined3d_rendertarget_view *	rtv
	)

Definition at line 405 of file surface.c.

{
    if (rtv)
        d3d8_surface_Release(&surface->IDirect3DSurface8_iface);
}

Referenced by d3d8_device_SetRenderTarget().

d3d8_surface_SetPrivateData()

static HRESULT WINAPI d3d8_surface_SetPrivateData ( IDirect3DSurface8 *  iface, REFGUID  guid, const void *  data, DWORD  data_size, DWORD  flags  )

static

Definition at line 137 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    TRACE("iface %p, guid %s, data %p, data_size %lu, flags %#lx.\n",
            iface, debugstr_guid(guid), data, data_size, flags);
 
    return d3d8_resource_set_private_data(&surface->resource, guid, data, data_size, flags);
}

d3d8_surface_UnlockRect()

static HRESULT WINAPI d3d8_surface_UnlockRect ( IDirect3DSurface8 *  iface )

static

Definition at line 267 of file surface.c.

{
    struct d3d8_surface *surface = impl_from_IDirect3DSurface8(iface);
    HRESULT hr;
 
    TRACE("iface %p.\n", iface);
 
    hr = wined3d_resource_unmap(wined3d_texture_get_resource(surface->wined3d_texture), surface->sub_resource_idx);
 
    if (hr == WINEDDERR_NOTLOCKED)
    {
        D3DRESOURCETYPE type;
        if (surface->texture)
            type = IDirect3DBaseTexture8_GetType(&surface->texture->IDirect3DBaseTexture8_iface);
        else
            type = D3DRTYPE_SURFACE;
        hr = type == D3DRTYPE_TEXTURE ? D3D_OK : D3DERR_INVALIDCALL;
    }
    return hr;
}

impl_from_IDirect3DSurface8()

static struct d3d8_surface * impl_from_IDirect3DSurface8 ( IDirect3DSurface8 *  iface )

inlinestatic

Definition at line 25 of file surface.c.

{
    return CONTAINING_RECORD(iface, struct d3d8_surface, IDirect3DSurface8_iface);
}

Referenced by d3d8_surface_AddRef(), d3d8_surface_FreePrivateData(), d3d8_surface_GetContainer(), d3d8_surface_GetDesc(), d3d8_surface_GetDevice(), d3d8_surface_GetPrivateData(), d3d8_surface_LockRect(), d3d8_surface_Release(), d3d8_surface_SetPrivateData(), d3d8_surface_UnlockRect(), and unsafe_impl_from_IDirect3DSurface8().

surface_wined3d_object_destroyed()

static void STDMETHODCALLTYPE surface_wined3d_object_destroyed ( void *  parent )

static

Definition at line 306 of file surface.c.

{
    struct d3d8_surface *surface = parent;
    d3d8_resource_cleanup(&surface->resource);
    free(surface);
}

unsafe_impl_from_IDirect3DSurface8()

struct d3d8_surface * unsafe_impl_from_IDirect3DSurface8

(

IDirect3DSurface8 *

iface

)

Definition at line 412 of file surface.c.

{
    if (!iface)
        return NULL;
    assert(iface->lpVtbl == &d3d8_surface_vtbl);
 
    return impl_from_IDirect3DSurface8(iface);
}

Referenced by d3d8_device_CopyRects(), d3d8_device_GetFrontBuffer(), d3d8_device_SetCursorProperties(), and d3d8_device_SetRenderTarget().

view_wined3d_object_destroyed()

static void STDMETHODCALLTYPE view_wined3d_object_destroyed ( void *  parent )

static

Definition at line 350 of file surface.c.

{
    struct d3d8_surface *surface = parent;
 
    /* If the surface reference count drops to zero, we release our reference
     * to the view, but don't clear the pointer yet, in case e.g. a
     * GetRenderTarget() call brings the surface back before the view is
     * actually destroyed. When the view is destroyed, we need to clear the
     * pointer, or a subsequent surface AddRef() would reference it again.
     *
     * This is safe because as long as the view still has a reference to the
     * texture, the surface is also still alive, and we're called before the
     * view releases that reference. */
    surface->wined3d_rtv = NULL;
    list_remove(&surface->rtv_entry);
}

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

d3d8

)

Variable Documentation

d3d8_surface_vtbl

const IDirect3DSurface8Vtbl d3d8_surface_vtbl

static

Initial value:

=
{
    
    d3d8_surface_QueryInterface,
    d3d8_surface_AddRef,
    d3d8_surface_Release,
    
    d3d8_surface_GetDevice,
    d3d8_surface_SetPrivateData,
    d3d8_surface_GetPrivateData,
    d3d8_surface_FreePrivateData,
    
    d3d8_surface_GetContainer,
    d3d8_surface_GetDesc,
    d3d8_surface_LockRect,
    d3d8_surface_UnlockRect,
}

Definition at line 288 of file surface.c.

Referenced by d3d8_surface_create(), and unsafe_impl_from_IDirect3DSurface8().

d3d8_surface_wined3d_parent_ops

const struct wined3d_parent_ops d3d8_surface_wined3d_parent_ops

static

Initial value:

=
{
    surface_wined3d_object_destroyed,
}

Definition at line 313 of file surface.c.

Referenced by d3d8_surface_create().

d3d8_view_wined3d_parent_ops

const struct wined3d_parent_ops d3d8_view_wined3d_parent_ops

static

Initial value:

=
{
    view_wined3d_object_destroyed,
}

Definition at line 367 of file surface.c.

Referenced by d3d8_surface_acquire_rendertarget_view().