core: 定义核心事件数据模型并更新其文档
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
#include <stddef.h>
|
||||
|
||||
#include "core/types.h"
|
||||
#include "wm_desc.h"
|
||||
#include "core/wm_desc.h"
|
||||
|
||||
/* 核心实体定义 */
|
||||
typedef struct wm_window_t {
|
||||
@@ -75,7 +75,8 @@ typedef struct wm_state_t {
|
||||
* - wm_state_init() / wm_state_cleanup() 必须成对调用
|
||||
* - 同一个 state 生命周期内,wm_state_init() 不允许重复调用
|
||||
* - 除 wm_state_init() 外,其余 state 相关接口都要求 state 已初始化
|
||||
* - workspaces[i] 必须满足 wm_workspace_desc_valid(&workspaces[i], output_count)
|
||||
* - workspaces[i] 必须满足 wm_workspace_desc_valid(&workspaces[i],
|
||||
* output_count)
|
||||
* - 传入空指针、未初始化对象或违反前置条件属于调用方错误
|
||||
*
|
||||
* 初始化时根据描述表构建 outputs[] 与 workspaces[]。
|
||||
@@ -84,8 +85,7 @@ typedef struct wm_state_t {
|
||||
* workspace;若某个 output 没有任何归属 workspace,wm_state_init() 会失败。
|
||||
*/
|
||||
void wm_state_init(wm_state_t *state, const wm_output_info_t *outputs,
|
||||
size_t output_count,
|
||||
const wm_workspace_desc_t *workspaces,
|
||||
size_t output_count, const wm_workspace_desc_t *workspaces,
|
||||
size_t workspace_count);
|
||||
void wm_state_cleanup(wm_state_t *state);
|
||||
|
||||
|
||||
Reference in New Issue
Block a user