玄武设备栈对象

玄武设备栈对象 的协作图:

结构体
struct	xwds_object
	设备栈对象 更多...

枚举
enum	xwds_object_refcnt_em { XWDS_OBJ_REF_REMOVE = 0 , XWDS_OBJ_REF_SHUTDOWN , XWDS_OBJ_REF_SUSPEND , XWDS_OBJ_REF_RUNNING }
	设备状态（引用计数）枚举 更多...

函数
void	xwds_obj_construct (struct xwds_object *obj)
void	xwds_obj_destruct (struct xwds_object *obj)
xwsq_t	xwds_obj_get_tik (struct xwds_object *obj)
xwer_t	xwds_obj_probe (struct xwds_object *obj, xwobj_gc_f gcfunc)
xwer_t	xwds_obj_remove (struct xwds_object *obj)
xwer_t	xwds_obj_start (struct xwds_object *obj)
xwer_t	xwds_obj_stop (struct xwds_object *obj)
xwer_t	xwds_obj_suspend (struct xwds_object *obj)
xwer_t	xwds_obj_resume (struct xwds_object *obj)
xwer_t	xwds_obj_grab (struct xwds_object *obj)
xwer_t	xwds_obj_put (struct xwds_object *obj)
xwsq_t	xwds_obj_get_refcnt (struct xwds_object *obj)
xwer_t	xwds_obj_add (struct xwds *ds, struct xwds_object *obj)
xwer_t	xwds_obj_del (struct xwds *ds, struct xwds_object *obj)

详细描述

枚举类型说明

xwds_object_refcnt_em

enum xwds_object_refcnt_em

设备状态（引用计数）枚举

枚举值
XWDS_OBJ_REF_REMOVE
XWDS_OBJ_REF_SHUTDOWN
XWDS_OBJ_REF_SUSPEND
XWDS_OBJ_REF_RUNNING

在文件 object.h 第 39 行定义.

                           {
        XWDS_OBJ_REF_REMOVE = 0,
        XWDS_OBJ_REF_SHUTDOWN,
        XWDS_OBJ_REF_SUSPEND,
        XWDS_OBJ_REF_RUNNING,
};

函数说明

xwds_obj_add()

xwer_t xwds_obj_add	(	struct xwds *	ds,
		struct xwds_object *	obj
	)

<No error

在文件 object.c 第 172 行定义.

{
        xwreg_t cpuirq;
        xwer_t rc;
 
        xwos_sqlk_wr_lock_cpuirqsv(&ds->devlistlock, &cpuirq);
        if (obj->ds) {
                rc = -EPERM;
        } else {
                xwlib_bclst_add_tail(&ds->devhead, &obj->node); /* LIFO */
                obj->ds = ds;
                rc = XWOK;
        }
        xwos_sqlk_wr_unlock_cpuirqrs(&ds->devlistlock, cpuirq);
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_construct()

void xwds_obj_construct

(

struct xwds_object *

obj

)

在文件 object.c 第 30 行定义.

{
        xwos_object_construct(&obj->xwobj);
        xwlib_bclst_init_node(&obj->node);
        obj->ds = NULL;
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_del()

xwer_t xwds_obj_del	(	struct xwds *	ds,
		struct xwds_object *	obj
	)

<Owner error

<No error

在文件 object.c 第 190 行定义.

{
        xwreg_t cpuirq;
        xwer_t rc;
 
        xwos_sqlk_wr_lock_cpuirqsv(&ds->devlistlock, &cpuirq);
        if (obj->ds != ds) {
                rc = -EOWNER;
        } else {
                xwlib_bclst_del_init(&obj->node); /* LIFO */
                obj->ds = NULL;
                rc = XWOK;
        }
        xwos_sqlk_wr_unlock_cpuirqrs(&ds->devlistlock, cpuirq);
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_destruct()

void xwds_obj_destruct

(

struct xwds_object *

obj

)

在文件 object.c 第 38 行定义.

{
        obj->ds = NULL;
        xwos_object_destruct(&obj->xwobj);
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_get_refcnt()

xwsq_t xwds_obj_get_refcnt

(

struct xwds_object *

obj

)

在文件 object.c 第 166 行定义.

{
        return xwos_object_get_refcnt(&obj->xwobj);
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_get_tik()

xwsq_t xwds_obj_get_tik

(

struct xwds_object *

obj

)

在文件 object.c 第 45 行定义.

{
        xwsq_t tik;
 
        if (obj) {
                tik = obj->xwobj.tik;
        } else {
                tik = 0;
        }
        return tik;
}

这是这个函数的调用关系图:

xwds_obj_grab()

xwer_t xwds_obj_grab

(

struct xwds_object *

obj

)

在文件 object.c 第 138 行定义.

{
        xwer_t rc;
 
        rc = xwaop_tge_then_add(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_RUNNING, 1,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

xwds_obj_probe()

xwer_t xwds_obj_probe	(	struct xwds_object *	obj,
		xwobj_gc_f	gcfunc
	)

在文件 object.c 第 58 行定义.

{
        return xwos_object_activate(&obj->xwobj, gcfunc);
}

函数调用图:

这是这个函数的调用关系图:

xwds_obj_put()

xwer_t xwds_obj_put

(

struct xwds_object *

obj

)

在文件 object.c 第 152 行定义.

{
        xwer_t rc;
 
        rc = xwaop_tgt_then_sub(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_RUNNING, 1,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

xwds_obj_remove()

xwer_t xwds_obj_remove

(

struct xwds_object *

obj

)

<No error

在文件 object.c 第 64 行定义.

{
        xwer_t rc;
 
        rc = xwaop_teq_then_sub(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_SHUTDOWN, 1,
                                NULL, NULL);
        if (XWOK == rc) {
                if (obj->xwobj.gcfunc) {
                        rc = obj->xwobj.gcfunc(&obj->xwobj);
                }
        } else {
                rc = -EPERM;
        }
        return rc;
}

这是这个函数的调用关系图:

xwds_obj_resume()

xwer_t xwds_obj_resume

(

struct xwds_object *

obj

)

在文件 object.c 第 124 行定义.

{
        xwer_t rc;
 
        rc = xwaop_teq_then_add(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_SUSPEND, 1,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

这是这个函数的调用关系图:

xwds_obj_start()

xwer_t xwds_obj_start

(

struct xwds_object *

obj

)

在文件 object.c 第 82 行定义.

{
        xwer_t rc;
 
        rc = xwaop_teq_then_add(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_SHUTDOWN, 2,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

这是这个函数的调用关系图:

xwds_obj_stop()

xwer_t xwds_obj_stop

(

struct xwds_object *

obj

)

在文件 object.c 第 96 行定义.

{
        xwer_t rc;
 
        rc = xwaop_teq_then_sub(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_RUNNING, 2,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

这是这个函数的调用关系图:

xwds_obj_suspend()

xwer_t xwds_obj_suspend

(

struct xwds_object *

obj

)

在文件 object.c 第 110 行定义.

{
        xwer_t rc;
 
        rc = xwaop_teq_then_sub(xwsq_t, &obj->xwobj.refcnt,
                                XWDS_OBJ_REF_RUNNING, 1,
                                NULL, NULL);
        if (rc < 0) {
                rc = -EPERM;
        }
        return rc;
}

这是这个函数的调用关系图: