r3/win/semeventmulti-win.cpp

	semeventmulti-win.cpp revision d05e58c15346e272284b3db3adae55a8fb8977da
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* $Id$ */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/** @file
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * IPRT - Multiple Release Event Semaphore, Windows.
d05e58c15346e272284b3db3adae55a8fb8977davboxsync *
d05e58c15346e272284b3db3adae55a8fb8977davboxsync * @remarks This file is identical to semevent-win.cpp except for the 2nd
d05e58c15346e272284b3db3adae55a8fb8977davboxsync *          CreateEvent parameter, the reset function and the "Multi" infix.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*
d05e58c15346e272284b3db3adae55a8fb8977davboxsync * Copyright (C) 2006-2010 Sun Microsystems, Inc.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * available from http://www.virtualbox.org. This file is free software;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * you can redistribute it and/or modify it under the terms of the GNU
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * General Public License (GPL) as published by the Free Software
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * The contents of this file may alternatively be used under the terms
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * of the Common Development and Distribution License Version 1.0
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * VirtualBox OSE distribution, in which case the provisions of the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * CDDL are applicable instead of those of the GPL.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * You may elect to license modified versions of this file under the
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * terms and conditions of either the GPL or the CDDL or both.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * additional information or have any questions.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*******************************************************************************
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*   Header Files                                                               *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*******************************************************************************/
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#define LOG_GROUP RTLOGGROUP_SEMAPHORE
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <Windows.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/semaphore.h>
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include "internal/iprt.h"
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include <iprt/asm.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/assert.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/err.h>
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include <iprt/lockvalidator.h>
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include <iprt/mem.h>
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include <iprt/thread.h>
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#include "internal/magics.h"
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include "internal/strict.h"
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*******************************************************************************
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*   Defined Constants And Macros                                               *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*******************************************************************************/
d05e58c15346e272284b3db3adae55a8fb8977davboxsyncstruct RTSEMEVENTMULTIINTERNAL
d05e58c15346e272284b3db3adae55a8fb8977davboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /** Magic value (RTSEMEVENTMULTI_MAGIC). */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    uint32_t            u32Magic;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /** The event handle. */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    HANDLE              hev;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /** Signallers. */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTLOCKVALRECSHRD    Signallers;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /** Indicates that lock validation should be performed. */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    bool volatile       fEverHadSignallers;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
d05e58c15346e272284b3db3adae55a8fb8977davboxsync};
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* Undefine debug mappings. */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemEventMultiWait
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemEventMultiWaitNoResume
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemEventMultiCreate(PRTSEMEVENTMULTI pEventMultiSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = (struct RTSEMEVENTMULTIINTERNAL *)RTMemAlloc(sizeof(*pThis));
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (!pThis)
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        return VERR_NO_MEMORY;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Create the semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * (Manual reset, not signaled, private event object.)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    pThis->hev = CreateEvent(NULL, TRUE, FALSE, NULL);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (pThis->hev != NULL) /* not INVALID_HANDLE_VALUE */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        pThis->u32Magic = RTSEMEVENTMULTI_MAGIC;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        RTLockValidatorRecSharedInit(&pThis->Signallers,
d05e58c15346e272284b3db3adae55a8fb8977davboxsync                                     NIL_RTLOCKVALIDATORCLASS, RTLOCKVALIDATOR_SUB_CLASS_ANY,
d05e58c15346e272284b3db3adae55a8fb8977davboxsync                                     "RTSemEvent", pThis, true /*fSignaller*/);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        pThis->fEverHadSignallers = false;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        *pEventMultiSem = pThis;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    }
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    DWORD dwErr = GetLastError();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTMemFree(pThis);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    return RTErrConvertFromWin32(dwErr);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemEventMultiDestroy(RTSEMEVENTMULTI EventMultiSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = EventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (pThis == NIL_RTSEMEVENT)        /* don't bitch */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        return VERR_INVALID_HANDLE;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturn(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     * Invalidate the handle and close the semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    int rc = VINF_SUCCESS;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturn(ASMAtomicCmpXchgU32(&pThis->u32Magic, ~RTSEMEVENTMULTI_MAGIC, RTSEMEVENTMULTI_MAGIC), VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (CloseHandle(pThis->hev))
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        RTLockValidatorRecSharedDelete(&pThis->Signallers);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        RTMemFree(pThis);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    }
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    else
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        DWORD dwErr = GetLastError();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        rc = RTErrConvertFromWin32(dwErr);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        AssertMsgFailed(("Destroy EventMultiSem %p failed, lasterr=%u (%Rrc)\n", pThis, dwErr, rc));
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        /* Leak it. */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    }
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    return rc;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemEventMultiSignal(RTSEMEVENTMULTI EventMultiSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /*
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     * Validate input.
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = EventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturn(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (pThis->fEverHadSignallers)
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        int rc9 = RTLockValidatorRecSharedCheckSignaller(&pThis->Signallers, NIL_RTTHREAD);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        if (RT_FAILURE(rc9))
d05e58c15346e272284b3db3adae55a8fb8977davboxsync            return rc9;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    }
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Signal the object.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (SetEvent(pThis->hev))
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    DWORD dwErr = GetLastError();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertMsgFailed(("Signaling EventMultiSem %p failed, lasterr=%d\n", pThis, dwErr));
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    return RTErrConvertFromWin32(dwErr);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemEventMultiReset(RTSEMEVENTMULTI EventMultiSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /*
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     * Validate input.
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = EventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturn(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Reset the object.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (ResetEvent(pThis->hev))
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        return VINF_SUCCESS;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    DWORD dwErr = GetLastError();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertMsgFailed(("Resetting EventMultiSem %p failed, lasterr=%d\n", pThis, dwErr));
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    return RTErrConvertFromWin32(dwErr);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int)  RTSemEventMultiWaitNoResume(RTSEMEVENTMULTI EventMultiSem, unsigned cMillies)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    PCRTLOCKVALSRCPOS pSrcPos = NULL;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    /*
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     * Validate input.
d05e58c15346e272284b3db3adae55a8fb8977davboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = EventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturn(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC, VERR_INVALID_HANDLE);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     * Wait for condition.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync     */
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTTHREAD hThreadSelf = RTThreadSelfAutoAdopt();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    if (pThis->fEverHadSignallers)
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        int rc9 = RTLockValidatorRecSharedCheckBlocking(&pThis->Signallers, hThreadSelf, pSrcPos, false,
d05e58c15346e272284b3db3adae55a8fb8977davboxsync                                                        RTTHREADSTATE_EVENT_MULTI, true);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        if (RT_FAILURE(rc9))
d05e58c15346e272284b3db3adae55a8fb8977davboxsync            return rc9;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    }
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#else
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTTHREAD hThreadSelf = RTThreadSelf();
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTThreadBlocking(hThreadSelf, RTTHREADSTATE_EVENT_MULTI, true);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    DWORD rc = WaitForSingleObjectEx(pThis->hev,
d05e58c15346e272284b3db3adae55a8fb8977davboxsync                                     cMillies == RT_INDEFINITE_WAIT ? INFINITE : cMillies,
d05e58c15346e272284b3db3adae55a8fb8977davboxsync                                     TRUE /*fAlertable*/);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTThreadUnblocked(hThreadSelf, RTTHREADSTATE_EVENT_MULTI);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    switch (rc)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_OBJECT_0:         return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_TIMEOUT:          return VERR_TIMEOUT;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_IO_COMPLETION:    return VERR_INTERRUPTED;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        case WAIT_ABANDONED:        return VERR_SEM_OWNER_DIED;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        default:
d05e58c15346e272284b3db3adae55a8fb8977davboxsync            AssertMsgFailed(("%u\n", rc));
d05e58c15346e272284b3db3adae55a8fb8977davboxsync        case WAIT_FAILED:
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        {
d05e58c15346e272284b3db3adae55a8fb8977davboxsync            AssertMsgFailed(("Wait on EventMultiSem %p failed, rc=%d lasterr=%d\n", pThis, rc, GetLastError()));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            int rc2 = RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            if (rc2)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync                return rc2;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            AssertMsgFailed(("WaitForSingleObject(event) -> rc=%d while converted lasterr=%d\n", rc, rc2));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync            return VERR_INTERNAL_ERROR;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync        }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync    }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsyncRTDECL(void) RTSemEventMultiSetSignaller(RTSEMEVENTMULTI hEventMultiSem, RTTHREAD hThread)
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = hEventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturnVoid(pThis);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturnVoid(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    ASMAtomicWriteBool(&pThis->fEverHadSignallers, true);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTLockValidatorRecSharedResetOwner(&pThis->Signallers, hThread, NULL);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync}
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsyncRTDECL(void) RTSemEventMultiAddSignaller(RTSEMEVENTMULTI hEventMultiSem, RTTHREAD hThread)
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = hEventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturnVoid(pThis);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturnVoid(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    ASMAtomicWriteBool(&pThis->fEverHadSignallers, true);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTLockValidatorRecSharedAddOwner(&pThis->Signallers, hThread, NULL);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync}
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsyncRTDECL(void) RTSemEventMultiRemoveSignaller(RTSEMEVENTMULTI hEventMultiSem, RTTHREAD hThread)
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync{
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#ifdef RTSEMEVENT_STRICT
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    struct RTSEMEVENTMULTIINTERNAL *pThis = hEventMultiSem;
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertPtrReturnVoid(pThis);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    AssertReturnVoid(pThis->u32Magic == RTSEMEVENTMULTI_MAGIC);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync
d05e58c15346e272284b3db3adae55a8fb8977davboxsync    RTLockValidatorRecSharedRemoveOwner(&pThis->Signallers, hThread);
d05e58c15346e272284b3db3adae55a8fb8977davboxsync#endif
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync}
333e7ab9cd83b32080826d06ac7b1951c684ccb5vboxsync