runonce.c File Reference

#include <rtl_vista.h>
#include <wine/config.h>
#include <wine/port.h>

Include dependency graph for runonce.c:

Go to the source code of this file.

Functions
void WINAPI	RtlRunOnceInitialize (RTL_RUN_ONCE *once)
DWORD WINAPI	RtlRunOnceBeginInitialize (RTL_RUN_ONCE *once, ULONG flags, void **context)
DWORD WINAPI	RtlRunOnceComplete (RTL_RUN_ONCE *once, ULONG flags, void *context)
DWORD WINAPI	RtlRunOnceExecuteOnce (RTL_RUN_ONCE *once, PRTL_RUN_ONCE_INIT_FN func, void *param, void **context)

Function Documentation

RtlRunOnceBeginInitialize()

DWORD WINAPI RtlRunOnceBeginInitialize	(	RTL_RUN_ONCE *	once,
		ULONG	flags,
		void **	context
	)

Definition at line 19 of file runonce.c.

{
    if (flags & RTL_RUN_ONCE_CHECK_ONLY)
    {
        ULONG_PTR val = (ULONG_PTR)once->Ptr;
 
        if (flags & RTL_RUN_ONCE_ASYNC) return STATUS_INVALID_PARAMETER;
        if ((val & 3) != 2) return STATUS_UNSUCCESSFUL;
        if (context) *context = (void *)(val & ~3);
        return STATUS_SUCCESS;
    }
 
    for (;;)
    {
        ULONG_PTR next, val = (ULONG_PTR)once->Ptr;
 
        switch (val & 3)
        {
        case 0:  /* first time */
            if (!interlocked_cmpxchg_ptr( &once->Ptr,
                                          (flags & RTL_RUN_ONCE_ASYNC) ? (void *)3 : (void *)1, 0 ))
                return STATUS_PENDING;
            break;
 
        case 1:  /* in progress, wait */
            if (flags & RTL_RUN_ONCE_ASYNC) return STATUS_INVALID_PARAMETER;
            next = val & ~3;
            if (interlocked_cmpxchg_ptr( &once->Ptr, (void *)((ULONG_PTR)&next | 1),
                                         (void *)val ) == (void *)val)
                NtWaitForKeyedEvent( 0, &next, FALSE, NULL );
            break;
 
        case 2:  /* done */
            if (context) *context = (void *)(val & ~3);
            return STATUS_SUCCESS;
 
        case 3:  /* in progress, async */
            if (!(flags & RTL_RUN_ONCE_ASYNC)) return STATUS_INVALID_PARAMETER;
            return STATUS_PENDING;
        }
    }
}

Referenced by RtlRunOnceExecuteOnce().

RtlRunOnceComplete()

DWORD WINAPI RtlRunOnceComplete	(	RTL_RUN_ONCE *	once,
		ULONG	flags,
		void *	context
	)

Definition at line 65 of file runonce.c.

{
    if ((ULONG_PTR)context & 3) return STATUS_INVALID_PARAMETER;
 
    if (flags & RTL_RUN_ONCE_INIT_FAILED)
    {
        if (context) return STATUS_INVALID_PARAMETER;
        if (flags & RTL_RUN_ONCE_ASYNC) return STATUS_INVALID_PARAMETER;
    }
    else context = (void *)((ULONG_PTR)context | 2);
 
    for (;;)
    {
        ULONG_PTR val = (ULONG_PTR)once->Ptr;
 
        switch (val & 3)
        {
        case 1:  /* in progress */
            if (interlocked_cmpxchg_ptr( &once->Ptr, context, (void *)val ) != (void *)val) break;
            val &= ~3;
            while (val)
            {
                ULONG_PTR next = *(ULONG_PTR *)val;
                NtReleaseKeyedEvent( 0, (void *)val, FALSE, NULL );
                val = next;
            }
            return STATUS_SUCCESS;
 
        case 3:  /* in progress, async */
            if (!(flags & RTL_RUN_ONCE_ASYNC)) return STATUS_INVALID_PARAMETER;
            if (interlocked_cmpxchg_ptr( &once->Ptr, context, (void *)val ) != (void *)val) break;
            return STATUS_SUCCESS;
 
        default:
            return STATUS_UNSUCCESSFUL;
        }
    }
}

Referenced by RtlRunOnceExecuteOnce().

RtlRunOnceExecuteOnce()

DWORD WINAPI RtlRunOnceExecuteOnce	(	RTL_RUN_ONCE *	once,
		PRTL_RUN_ONCE_INIT_FN	func,
		void *	param,
		void **	context
	)

Definition at line 107 of file runonce.c.

{
    DWORD ret = RtlRunOnceBeginInitialize( once, 0, context );
 
    if (ret != STATUS_PENDING) return ret;
 
    if (!func( once, param, context ))
    {
        RtlRunOnceComplete( once, RTL_RUN_ONCE_INIT_FAILED, NULL );
        return STATUS_UNSUCCESSFUL;
    }
 
    return RtlRunOnceComplete( once, 0, context ? *context : NULL );
}

Referenced by InitOnceExecuteOnce().

RtlRunOnceInitialize()

void WINAPI RtlRunOnceInitialize

(

RTL_RUN_ONCE *

once

)

Definition at line 11 of file runonce.c.

{
    once->Ptr = NULL;
}