86 lines
2.9 KiB
C
86 lines
2.9 KiB
C
/* SPDX-License-Identifier: MIT OR X11
|
|
*
|
|
* Copyright © 2024 Enrico Weigelt, metux IT consult <info@metux.net>
|
|
*/
|
|
#ifndef _XSERVER_DIX_RESOURCE_PRIV_H
|
|
#define _XSERVER_DIX_RESOURCE_PRIV_H
|
|
|
|
#include "include/dix.h"
|
|
|
|
/*
|
|
* @brief retrieve client that owns given window
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* @param WindowPtr to the window whose client shall be retrieved
|
|
* @return pointer to ClientRec structure or NullClient (NULL)
|
|
*/
|
|
ClientPtr dixClientForWindow(WindowPtr pWin);
|
|
|
|
/*
|
|
* @brief retrieve client that owns given grab
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* @param GrabPtr to the grab whose owning client shall be retrieved
|
|
* @return pointer to ClientRec structure or NullClient (NULL)
|
|
*/
|
|
ClientPtr dixClientForGrab(GrabPtr pGrab);
|
|
|
|
/*
|
|
* @brief retrieve client that owns InputClients
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* @param GrabPtr to the InputClients whose owning client shall be retrieved
|
|
* @return pointer to ClientRec structure or NullClient (NULL)
|
|
*/
|
|
ClientPtr dixClientForInputClients(InputClientsPtr pInputClients);
|
|
|
|
/*
|
|
* @brief retrieve client that owns OtherClients
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* @param GrabPtr to the OtherClients whose owning client shall be retrieved
|
|
* @return pointer to ClientRec structure or NullClient (NULL)
|
|
*/
|
|
ClientPtr dixClientForOtherClients(OtherClientsPtr pOtherClients);
|
|
|
|
/*
|
|
* @brief extract client ID from XID
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* This ID is frequently used as table index, eg. for client or resource lookup.
|
|
*
|
|
* @param XID the ID of the resource whose client is retrieved
|
|
* @return index of the client (within client or resource table)
|
|
*/
|
|
static inline int dixClientIdForXID(XID xid) {
|
|
return ((int)(CLIENT_BITS(xid) >> CLIENTOFFSET));
|
|
}
|
|
|
|
/*
|
|
* @brief retrieve client pointer from XID
|
|
*
|
|
* XIDs carry the ID of the client who created/owns the resource in upper bits.
|
|
* (every client so is assigned a range of XIDs it may use for resource creation)
|
|
*
|
|
* @param XID the ID of the resource whose client is retrieved
|
|
* @return pointer to ClientRec structure or NullClient (NULL)
|
|
*/
|
|
static inline ClientPtr dixClientForXID(XID xid) {
|
|
const int idx = dixClientIdForXID(xid);
|
|
if (idx < MAXCLIENTS)
|
|
return clients[idx];
|
|
return NullClient;
|
|
}
|
|
|
|
#endif /* _XSERVER_DIX_RESOURCE_PRIV_H */
|