Changeset 90488 in vbox for trunk/include

Timestamp:

Aug 3, 2021 9:17:59 AM (4 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

146092

Message:

IPRT: Added RTSemEventIsSignalSafe and RTSemEventMultiIsSignalSafe - ring-0 only. bugref:6695

Location:

trunk/include/iprt

Files:

trunk/include/iprt/mangling.h

-              r90416
+              r90488
 # define RTSemEventDestroy                              RT_MANGLER(RTSemEventDestroy)
 # define RTSemEventGetResolution                        RT_MANGLER(RTSemEventGetResolution)    /* r0drv */
+# define RTSemEventIsSignalSafe                         RT_MANGLER(RTSemEventIsSignalSafe)     /* r0drv */
 # define RTSemEventMultiAddSignaller                    RT_MANGLER(RTSemEventMultiAddSignaller)
 # define RTSemEventMultiCreate                          RT_MANGLER(RTSemEventMultiCreate)
 …
 # define RTSemEventMultiDestroy                         RT_MANGLER(RTSemEventMultiDestroy)
 # define RTSemEventMultiGetResolution                   RT_MANGLER(RTSemEventMultiGetResolution) /* r0drv */
+# define RTSemEventMultiIsSignalSafe                    RT_MANGLER(RTSemEventMultiIsSignalSafe) /* r0drv */
 # define RTSemEventMultiRemoveSignaller                 RT_MANGLER(RTSemEventMultiRemoveSignaller)
 # define RTSemEventMultiReset                           RT_MANGLER(RTSemEventMultiReset)

-              r82968
+              r90488
 /**
+ * Whether RTSemEventSignal can be safely called w/o risk of preemption.
+ *
+ * Checks whether the caller can safely signal a single release semaphore
+ * without any risk of getting preempted on locks or similar while doing so.
+ * This also checks whether the context is suitable in general.
+ *
+ * @returns true if safe, false if not.
+ * @remarks Only ring-0.
+ */
+RTR0DECL(bool) RTSemEventIsSignalSafe(void);
+/**
  * Wait for the event semaphore to be signaled, resume on interruption.
+ *
 …
  */
 RTDECL(int)  RTSemEventMultiSignal(RTSEMEVENTMULTI hEventMultiSem);
+/**
+ * Whether RTSemEventMultiSignal can be safely called w/o risk of preemption.
+ *
+ * Checks whether the caller can safely signal a multiple release semaphore
+ * without any risk of getting preempted on locks or similar while doing so.
+ * This also checks whether the context is suitable in general.
+ *
+ * @returns true if safe, false if not.
+ * @remarks Only ring-0.
+ */
+RTR0DECL(bool) RTSemEventMultiIsSignalSafe(void);
 /**

Note: See TracChangeset for help on using the changeset viewer.