semmutex-win.cpp revision 08870164da59f90379b1ea9b5a2476296c362217
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* $Id$ */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/** @file
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * IPRT - Mutex Semaphores, Windows.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Copyright (C) 2006-2009 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>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include "internal/iprt.h"
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/assert.h>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include <iprt/asm.h>
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include <iprt/err.h>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include <iprt/lockvalidator.h>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include <iprt/mem.h>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include <iprt/thread.h>
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#include "internal/magics.h"
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#include "internal/strict.h"
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/*******************************************************************************
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync* Defined Constants And Macros *
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync*******************************************************************************/
0d282f291fba8c5597b0cc338058a7976938975cvboxsync/** Posix internal representation of a Mutex semaphore. */
0d282f291fba8c5597b0cc338058a7976938975cvboxsyncstruct RTSEMMUTEXINTERNAL
0d282f291fba8c5597b0cc338058a7976938975cvboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /** Magic value (RTSEMMUTEX_MAGIC). */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync uint32_t u32Magic;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /** The mutex handle. */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync HANDLE hMtx;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /** Lock validator record associated with this mutex. */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTLOCKVALIDATORREC ValidatorRec;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync};
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync/* Undefine debug mappings. */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemMutexRequest
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#undef RTSemMutexRequestNoResume
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int) RTSemMutexCreate(PRTSEMMUTEX pMutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync int rc;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Create the semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync HANDLE hMtx = CreateMutex(NULL, FALSE, NULL);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (hMtx)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync {
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTSEMMUTEXINTERNAL *pThis = (RTSEMMUTEXINTERNAL *)RTMemAlloc(sizeof(*pThis));
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (pThis)
0d282f291fba8c5597b0cc338058a7976938975cvboxsync {
0d282f291fba8c5597b0cc338058a7976938975cvboxsync pThis->u32Magic = RTSEMMUTEX_MAGIC;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync pThis->hMtx = hMtx;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTLockValidatorInit(&pThis->ValidatorRec, NIL_RTLOCKVALIDATORCLASS, RTLOCKVALIDATOR_SUB_CLASS_NONE, NULL, pThis);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync *pMutexSem = pThis;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return VINF_SUCCESS;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync }
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync rc = VERR_NO_MEMORY;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync }
0d282f291fba8c5597b0cc338058a7976938975cvboxsync else
0d282f291fba8c5597b0cc338058a7976938975cvboxsync rc = RTErrConvertFromWin32(GetLastError());
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return rc;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsyncRTDECL(int) RTSemMutexDestroy(RTSEMMUTEX MutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync /*
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * Validate.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTSEMMUTEXINTERNAL *pThis = MutexSem;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (pThis == NIL_RTSEMMUTEX)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync return VINF_SUCCESS;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertReturn(pThis->u32Magic == RTSEMMUTEX_MAGIC, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /*
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * Close semaphore handle.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertReturn(ASMAtomicCmpXchgU32(&pThis->u32Magic, RTSEMMUTEX_MAGIC_DEAD, RTSEMMUTEX_MAGIC), VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync HANDLE hMtx = pThis->hMtx;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync ASMAtomicWritePtr((void * volatile *)&pThis->hMtx, (void *)INVALID_HANDLE_VALUE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync int rc = VINF_SUCCESS;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (!CloseHandle(hMtx))
0d282f291fba8c5597b0cc338058a7976938975cvboxsync {
0d282f291fba8c5597b0cc338058a7976938975cvboxsync rc = RTErrConvertFromWin32(GetLastError());
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertMsgFailed(("%p rc=%d lasterr=%d\n", pThis->hMtx, rc, GetLastError()));
0d282f291fba8c5597b0cc338058a7976938975cvboxsync }
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTLockValidatorDelete(&pThis->ValidatorRec);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTMemFree(pThis);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return rc;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync/**
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * Internal worker for RTSemMutexRequestNoResume and it's debug companion.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync *
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * @returns Same as RTSEmMutexRequestNoResume
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * @param MutexSem The mutex handle.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * @param cMillies The number of milliseconds to wait.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * @param TSEMMUTEX_STRICT_POS_DECL The source position of the caller.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsyncDECL_FORCE_INLINE(int) rtSemMutexRequestNoResume(RTSEMMUTEX MutexSem, unsigned cMillies, RTSEMMUTEX_STRICT_POS_DECL)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /*
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * Validate.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTSEMMUTEXINTERNAL *pThis = MutexSem;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertReturn(pThis->u32Magic == RTSEMMUTEX_MAGIC, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTTHREAD hThreadSelf = RTThreadSelfAutoAdopt();
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTLockValidatorCheckOrder(&pThis->ValidatorRec, hThreadSelf, RTSEMMUTEX_STRICT_POS_ARGS);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#else
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTTHREAD hThreadSelf = RTThreadSelf();
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Lock mutex semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (cMillies > 0)
08870164da59f90379b1ea9b5a2476296c362217vboxsync {
08870164da59f90379b1ea9b5a2476296c362217vboxsync#ifdef RTSEMMUTEX_STRICT
08870164da59f90379b1ea9b5a2476296c362217vboxsync int rc9 = RTLockValidatorCheckBlocking(&pThis->ValidatorRec, hThreadSelf,
08870164da59f90379b1ea9b5a2476296c362217vboxsync RTTHREADSTATE_MUTEX, true, uId, RT_SRC_POS_ARGS);
08870164da59f90379b1ea9b5a2476296c362217vboxsync if (RT_FAILURE(rc9))
08870164da59f90379b1ea9b5a2476296c362217vboxsync return rc9;
08870164da59f90379b1ea9b5a2476296c362217vboxsync#else
08870164da59f90379b1ea9b5a2476296c362217vboxsync RTThreadBlocking(hThreadSelf, RTTHREADSTATE_MUTEX);
08870164da59f90379b1ea9b5a2476296c362217vboxsync#endif
08870164da59f90379b1ea9b5a2476296c362217vboxsync }
0d282f291fba8c5597b0cc338058a7976938975cvboxsync int rc = WaitForSingleObjectEx(pThis->hMtx,
0d282f291fba8c5597b0cc338058a7976938975cvboxsync cMillies == RT_INDEFINITE_WAIT ? INFINITE : cMillies,
0d282f291fba8c5597b0cc338058a7976938975cvboxsync TRUE /*bAlertable*/);
08870164da59f90379b1ea9b5a2476296c362217vboxsync RTThreadUnblocked(hThreadSelf, RTTHREADSTATE_MUTEX);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync switch (rc)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync case WAIT_OBJECT_0:
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#ifdef RTSEMMUTEX_STRICT
08870164da59f90379b1ea9b5a2476296c362217vboxsync RTLockValidatorSetOwner(&pThis->ValidatorRec, hThreadSelf, RTSEMMUTEX_STRICT_POS_ARGS);
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#endif
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync return VINF_SUCCESS;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
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:
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync {
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync AssertMsgFailed(("Wait on MutexSem %p failed, rc=%d lasterr=%d\n", MutexSem, rc, GetLastError()));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync int rc2 = RTErrConvertFromWin32(GetLastError());
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync if (rc2 != 0)
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
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsyncRTDECL(int) RTSemMutexRequestNoResume(RTSEMMUTEX MutexSem, unsigned cMillies)
0d282f291fba8c5597b0cc338058a7976938975cvboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifndef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return rtSemMutexRequestNoResume(MutexSem, cMillies, RTSEMMUTEX_STRICT_POS_ARGS);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#else
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return RTSemMutexRequestNoResumeDebug(MutexSem, cMillies, (uintptr_t)ASMReturnAddress(), RT_SRC_POS);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync}
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsyncRTDECL(int) RTSemMutexRequestNoResumeDebug(RTSEMMUTEX MutexSem, unsigned cMillies, RTHCUINTPTR uId, RT_SRC_POS_DECL)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return rtSemMutexRequestNoResume(MutexSem, cMillies, RTSEMMUTEX_STRICT_POS_ARGS);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#else
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync return RTSemMutexRequestNoResume(MutexSem, cMillies);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync#endif
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync
0d282f291fba8c5597b0cc338058a7976938975cvboxsyncRTDECL(int) RTSemMutexRelease(RTSEMMUTEX MutexSem)
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync{
0d282f291fba8c5597b0cc338058a7976938975cvboxsync /*
0d282f291fba8c5597b0cc338058a7976938975cvboxsync * Validate.
0d282f291fba8c5597b0cc338058a7976938975cvboxsync */
0d282f291fba8c5597b0cc338058a7976938975cvboxsync RTSEMMUTEXINTERNAL *pThis = MutexSem;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertReturn(pThis->u32Magic == RTSEMMUTEX_MAGIC, VERR_INVALID_HANDLE);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync /*
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync * Unlock mutex semaphore.
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync */
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#ifdef RTSEMMUTEX_STRICT
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if ( pThis->ValidatorRec.hThread != NIL_RTTHREAD
0d282f291fba8c5597b0cc338058a7976938975cvboxsync && pThis->ValidatorRec.hThread == RTThreadSelf())
08870164da59f90379b1ea9b5a2476296c362217vboxsync RTLockValidatorUnsetOwner(&pThis->ValidatorRec);
0d282f291fba8c5597b0cc338058a7976938975cvboxsync else
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertMsgFailed(("%p hThread=%RTthrd\n", pThis, pThis->ValidatorRec.hThread));
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync#endif
0d282f291fba8c5597b0cc338058a7976938975cvboxsync if (ReleaseMutex(pThis->hMtx))
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync return VINF_SUCCESS;
0d282f291fba8c5597b0cc338058a7976938975cvboxsync int rc = RTErrConvertFromWin32(GetLastError());
0d282f291fba8c5597b0cc338058a7976938975cvboxsync AssertMsgFailed(("%p/%p, rc=%Rrc lasterr=%d\n", pThis, pThis->hMtx, rc, GetLastError()));
0d282f291fba8c5597b0cc338058a7976938975cvboxsync return rc;
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync}
5964f60ed7fb52a3c4becbe83c9429f9b2f119c2vboxsync