/*++
Function:
PAL_Enter
Abstract:
This function needs to be called on a thread when it enters
a region of code that depends on this instance of the PAL
in the process, and the current thread may or may not be
known to the PAL. This function can fail (for something else
than an internal error) if this is the first time that the
current thread entered this PAL. Note that PAL_Initialize
implies a call to this function.
NOTE: This function must not modify LastError.
--*/
PAL_ERROR
PALAPI
PAL_Enter(PAL_Boundary boundary)
{
ENTRY_EXTERNAL("PAL_Enter(boundary=%u)\n", boundary);
PAL_ERROR palError = ERROR_SUCCESS;
CPalThread *pThread = GetCurrentPalThread();
if (pThread != NULL)
{
palError = pThread->Enter(boundary);
}
else
{
// If this assert fires, we'll have to pipe this information so that
// CPalThread's RunPostCreateInitializers call to SEHEnable
// can know what direction.
_ASSERT_MSG(PAL_BoundaryTop == boundary, "How are we entering a PAL "
"thread for the first time not from the top? (boundary=%u)", boundary);
palError = AllocatePalThread(&pThread);
if (NO_ERROR != palError)
{
ERROR("Unable to allocate pal thread: error %d\n", palError);
}
}
LOGEXIT("PAL_Enter returns %d\n", palError);
return palError;
}
/*++
Function:
PAL_ReenterForEH
Abstract:
This function needs to be called on a thread when it enters
a region of code that depends on this instance of the PAL
in the process, and it is unknown whether the current thread
is already running in the PAL. Returns TRUE if and only if
the thread was not running in the PAL previously.
NOTE: This function must not modify LastError.
--*/
BOOL
PALAPI
PAL_ReenterForEH()
{
// Only trace if we actually reenter (otherwise, too verbose)
// ENTRY_EXTERNAL("PAL_ReenterForEH()\n");
// Thus we have to split up what ENTRY_EXTERNAL does.
CHECK_STACK_ALIGN;
BOOL fEntered = FALSE;
CPalThread *pThread = GetCurrentPalThread();
if (pThread == NULL)
{
ASSERT("PAL_ReenterForEH called on a thread unknown to this PAL\n");
}
else if (!pThread->IsInPal())
{
#if !_NO_DEBUG_MESSAGES_
DBG_PRINTF(DLI_ENTRY, defdbgchan, TRUE)("PAL_ReenterForEH()\n");
#endif
// We ignore the return code. This call should only fail on internal
// error, and we assert at the actual failure.
pThread->Enter(PAL_BoundaryEH);
fEntered = TRUE;
LOGEXIT("PAL_ReenterForEH returns TRUE\n");
}
else
{
// LOGEXIT("PAL_ReenterForEH returns FALSE\n");
}
return fEntered;
}
/*++
Function:
PAL_Enter
Abstract:
This function needs to be called on a thread when it enters
a region of code that depends on this instance of the PAL
in the process, and the current thread may or may not be
known to the PAL. This function can fail (for something else
than an internal error) if this is the first time that the
current thread entered this PAL. Note that PAL_Initialize
implies a call to this function.
NOTE: This function must not modify LastError.
--*/
PAL_ERROR
PALAPI
PAL_Enter(PAL_Boundary boundary)
{
ENTRY_EXTERNAL("PAL_Enter(boundary=%u)\n", boundary);
PAL_ERROR palError = ERROR_SUCCESS;
CPalThread *pThread = InternalGetCurrentThread();
if (pThread != NULL)
{
palError = pThread->Enter(boundary);
}
else
{
// If this assert fires, we'll have to pipe this information so that
// CPalThread's RunPostCreateInitializers call to SEHEnable
// can know what direction.
_ASSERT_MSG(PAL_BoundaryTop == boundary, "How are we entering a PAL "
"thread for the first time not from the top? (boundary=%u)", boundary);
palError = CreateThreadData(&pThread);
if (NO_ERROR != palError)
{
ERROR("Unable to create thread data: error %d\n", palError);
goto EXIT;
}
HANDLE hThread;
palError = CreateThreadObject(pThread, pThread, &hThread);
if (NO_ERROR != palError)
{
ERROR("Unable to create thread object: error %d\n", palError);
pthread_setspecific(thObjKey, NULL);
pThread->ReleaseThreadReference();
goto EXIT;
}
// Like CreateInitialProcessAndThreadObjects, we do not need this
// thread handle, since we're not returning it to anyone who will
// possibly release it.
(void)g_pObjectManager->RevokeHandle(pThread, hThread);
PROCAddThread(pThread, pThread);
}
EXIT:
LOGEXIT("PAL_Enter returns %d\n", palError);
return palError;
}
/*++
Function:
PAL_Reenter
Abstract:
This function needs to be called on a thread when it enters
a region of code that depends on this instance of the PAL
in the process, and the current thread is already known to
the PAL.
NOTE: This function must not modify LastError.
--*/
VOID
PALAPI
PAL_Reenter(PAL_Boundary boundary)
{
ENTRY_EXTERNAL("PAL_Reenter(boundary=%u)\n", boundary);
CPalThread *pThread = GetCurrentPalThread();
if (pThread == NULL)
{
ASSERT("PAL_Reenter called on a thread unknown to this PAL\n");
}
// We ignore the return code. This call should only fail on internal
// error, and we assert at the actual failure.
pThread->Enter(boundary);
LOGEXIT("PAL_Reenter returns\n");
}
