XpQueryScreens(3Xp)

💖 NAME 💖

okay so bestie, welcome to XpQueryScreens(3Xp) — the XPRINT FUNCTIONS page that’s basically a vibe check for your X Server screens. It queries an X Server to determine which screens, of all the screens on the server, support the X Print Service Extension. 💅✨

✨ SYNOPSIS ✨

             cc [ flag... ] file... -lXp [ library... ]
             #include <X11/extensions/Print.h>

       Screen **XpQueryScreens ( display, list_count_return )
             Display *display;
             int *list_count_return;

🎀 ARGUMENTS 🎀

• display — a pointer to the Display structure; you know, the one returned from XOpenDisplay. 🫶
• list_count_return — returns the number of screens in the list. literally the count, bestie. 🔢

🦋 DESCRIPTION 🦋

so this request returns a non-NULL pointer to a list of screen pointers if one or more screens support the X Print Service Extension; otherwise it returns NULL. no cap. 💖

XpQueryScreens determines if the X Print Service Extension is present, and if it is, which of all the screens on the X Server support the X Print Service Extension. iconic behavior. 👑

unlike many other extensions, the X Print Service Extension may be restricted to a subset of all available screens — for example, a single X Server may be supporting video displays on some screens and printers on others. it’s giving “not every screen is invited to the print party” energy. 🎀🖨️

the list of screen pointers can be freed by calling XFree. super important, bestie — clean up after yourself. ✨

signed off with love from X Version 11, libXp 1.0.4, and XpQueryScreens(3Xp) itself. mwah 💋💜