---
name: "xcb_composite_redirect_subwindows_checked"
section: "3"
platform: "linux"
package: "libxcb"
version: "1.17.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xcb_composite_redirect_subwindows"
---

# xcb\_composite\_redirect\_subwindows\_checked(3)

Redirect all current and future children of ‘window’

Part of [xcb\_composite\_redirect\_subwindows(3)](/xcb_composite_redirect_subwindows/3.md).

## NAME

xcb\_composite\_redirect\_subwindows - Redirect all current and future children of ‘window’

## SYNOPSIS

**#include \<xcb/composite.h\>**

### Request function

xcb\_void\_cookie\_t **xcb\_composite\_redirect\_subwindows**(xcb\_connection\_t \**conn*, xcb\_window\_t *window*, uint8\_t *update*);\

## REQUEST ARGUMENTS

- *conn*

  The XCB connection to X11.

- *window*

  The root of the hierarchy to redirect to off-screen storage.

- *update*

  Whether contents are automatically mirrored to the parent window.  If one client\
   	already specifies an update type of Manual, any attempt by another to specify a\
   	mode of Manual so will result in an Access error.

## DESCRIPTION

Hierarchies starting at all current and future children of window\
 	will be redirected as in RedirectWindow. If update is Manual,\
 	then painting of the window background during window manipulation\
 	and ClearArea requests is inhibited.

## RETURN VALUE

Returns an *xcb\_void\_cookie\_t*. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with *xcb\_request\_check* instead, use *xcb\_composite\_redirect\_subwindows\_checked*. See **[xcb-requests(3)](/xcb-requests/3.md)** for details.

## ERRORS

This request does never generate any errors.

## SEE ALSO

[**xcb-requests**(3)](/xcb-requests/3.md)

## AUTHOR

Generated from composite.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.