DosReleaseSpinLock

Description

Release a spinlock for multiprocessor serialization

APIRET DosReleaseSpinLock (HSPINLOCK Handle)

Handle (HSPINLOCK) - input A handle to a spinlock. This handle was returned by DosCreateSpinLock.

ulrc (APIRET) DosReleaseSpinLock returns the following values:

NO_ERROR

ERROR_INVALID_HANDLE

DosReleaseSpinLock is passed a handle which was returned by DosCreateSpinLock When control is returned to the requester, the spin lock is released and interrupts are enabled. A DosAcquireSpinLock must have been previously issued.

DosAcquireSpinLock

DosCreateSpinLock

The following code example shows the use of DosReleaseSpinLock:

#define INCL_BASE
#define OS2_API16
#define INCL_DOSSPINLOCK
#include <os2.h>
#include <stdio.h>
#include <string.h>

main()
{
    APIRET      rc;                     /* Return code */
    HSPINLOCK   Handle;                 /* Handle to spin lock */
    PHSPINLOCK  pHandle = &Handle;  /* pointer to spin lock handle */

    /* Create a spin lock */

    rc = DosCreateSpinLock(pHandle);

    if (rc !=0)
      {
        printf("DosCreateSpinLock failed -- rc = %1d",rc);
        DosExit(0,1);
      }

    /* Acquire spin lock */

    rc = DosAcquireSpinLock(Handle);

    if (rc !=0)
      {
        printf("DosAcquireSpinLock failed -- rc = %1d",rc);
        DosExit(0,1);
      }

    /* Code that needs serialization */

    /* Release spin lock */

    rc = DosReleaseSpinLock(Handle);

    if (rc !=0)
      {
        printf("DosReleaseSpinLock failed -- rc = %1d",rc);
        DosExit(0,1);
      }
}