如何实现窗口管理器模块接收客户端模块的XCB_MAP_REQUEST事件？

1. 确保窗口管理器获取必要权限 #

你的窗口管理器模块在初始化阶段，必须向X服务器申请SUBSTRUCTURE_REDIRECT和SUBSTRUCTURE_NOTIFY权限——这是拦截XCB_MAP_REQUEST事件的核心前提。示例代码如下：

xcb_void_cookie_t cookie = xcb_change_window_attributes_checked(
    conn,
    root_window,
    XCB_CW_EVENT_MASK,
    (uint32_t[]){XCB_EVENT_MASK_SUBSTRUCTURE_REDIRECT | XCB_EVENT_MASK_SUBSTRUCTURE_NOTIFY}
);
xcb_generic_error_t *err = xcb_request_check(conn, cookie);
if (err) {
    // 处理权限获取失败（如已有其他窗口管理器运行）
    free(err);
    exit(1);
}

若未获取该权限，X服务器会直接处理窗口映射，不会将XCB_MAP_REQUEST转发给你的窗口管理器。

2. 客户端模块创建窗口时遵循标准规则 #

如果客户端模块的窗口是在窗口管理器进程内创建的，需避免绕过事件拦截：

• 不要给窗口设置XCB_WM_STATE_WITHDRAWN属性，也不要在创建时直接设置映射状态
• 确保窗口的override_redirect属性设为False（默认值即为False，若手动开启需关闭）

-- Lua客户端模块创建窗口的示例（假设封装了XCB调用）
local win = xcb_create_window(conn, XCB_COPY_FROM_PARENT, parent, 0,0, 200,200, 0,
    XCB_WINDOW_CLASS_INPUT_OUTPUT, screen.root_visual,
    XCB_CW_OVERRIDE_REDIRECT, {false}) -- 明确关闭override_redirect

若override_redirect设为True，X服务器会直接映射窗口，不会向窗口管理器发送XCB_MAP_REQUEST。

3. 规范客户端模块的映射调用流程 #

客户端模块调用xcb_map_window时，需保证：

• 窗口已完成创建，且未被提前映射
• 调用后执行xcb_flush(conn)刷新请求队列，确保事件发送到X服务器

-- Lua端映射调用示例
xcb_map_window(conn, win)
xcb_flush(conn) -- 必须触发请求发送

若未执行flush，请求会滞留在缓冲区，窗口管理器无法收到事件。

4. 调试事件接收逻辑 #

若仍未收到事件，可在窗口管理器的事件循环中打印所有收到的事件，确认XCB_MAP_REQUEST是否被触发：

while (true) {
    xcb_generic_event_t *evt = xcb_wait_for_event(conn);
    if (!evt) break;
    printf("Received event type: %d\n", evt->response_type & 0x7F);
    // 处理MAP_REQUEST事件
    if ((evt->response_type & 0x7F) == XCB_MAP_REQUEST) {
        xcb_map_request_event_t *req = (xcb_map_request_event_t*)evt;
        // 这里编写你的映射逻辑，如xcb_map_window(conn, req->window)
    }
    free(evt);
}

XCB_MAP_REQUEST的事件类型为20，如果日志中未出现该值，检查权限或窗口属性设置；若出现则排查后续处理逻辑。

5. 避免过滤自身创建的窗口 #

部分窗口管理器会对自身创建的窗口跳过管理逻辑，需确保客户端模块的窗口未被这类逻辑排除——比如不要根据PID、进程标识过滤XCB_MAP_REQUEST事件。

内容的提问来源于stack exchange，提问作者DesertCarMechanic