Changeset 10788 in vbox for trunk/include

Timestamp:

Jul 21, 2008 4:44:33 PM (17 years ago)

Author:

vboxsync

Message:

IPRT: Implemented the context variant of the handle table.

File:

• trunk/include/iprt/handletable.h (modified) (3 diffs)

trunk/include/iprt/handletable.h

@@ -98 +98 @@
  * If not specfied the caller will have to take care of that. */
 #define RTHANDLETABLE_FLAGS_LOCKED      RT_BIT_32(1)
+/** The mask of valid flags. */
+#define RTHANDLETABLE_FLAGS_MASK        UINT32_C(0x00000003)
 /* @} */
 
@@ -116 +118 @@
  *                          first handle to be returned.
  * @param   cMax            The max number of handles. When exceeded the RTHandleTableAlloc
- *                          or RTHandleTableAllocWithCtx calls will fail.
+ *                          or RTHandleTableAllocWithCtx calls will fail. Note that this
+ *                          number will be rounded up to a multiple of the sub-table size,
+ *                          or if it's too close to UINT32_MAX it will be rounded down.
  * @param   pfnRetain       Optional retain callback that will be called from behind the
  *                          lock (if any) during lookup.
@@ -127 +131 @@
  * A simplified version of the RTHandleTableCreateEx API.
  *
- * It assumes a max of 65534 handles with 1 being the base. The table
- * serialized (RTHANDLETABLE_FLAGS_LOCKED).
+ * It assumes a max of about 64K handles with 1 being the base. The table
+ * access will serialized (RTHANDLETABLE_FLAGS_LOCKED).
  *
  * @returns IPRT status code and *phHandleTable.