Rev 2726 | Details | Compare with Previous | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 2726 | vana | 1 | /*++ |
| 2 | |||
| 3 | Copyright (c) 1998 Intel Corporation |
||
| 4 | |||
| 5 | Module Name: |
||
| 6 | |||
| 7 | lock.c |
||
| 8 | |||
| 9 | Abstract: |
||
| 10 | |||
| 11 | Implements FLOCK |
||
| 12 | |||
| 13 | |||
| 14 | |||
| 15 | Revision History |
||
| 16 | |||
| 17 | --*/ |
||
| 18 | |||
| 19 | |||
| 20 | #include "lib.h" |
||
| 21 | |||
| 22 | |||
| 23 | VOID |
||
| 24 | InitializeLock ( |
||
| 25 | IN OUT FLOCK *Lock, |
||
| 26 | IN EFI_TPL Priority |
||
| 27 | ) |
||
| 28 | /*++ |
||
| 29 | |||
| 30 | Routine Description: |
||
| 31 | |||
| 32 | Initialize a basic mutual exclusion lock. Each lock |
||
| 33 | provides mutual exclusion access at it's task priority |
||
| 34 | level. Since there is no-premption (at any TPL) or |
||
| 35 | multiprocessor support, acquiring the lock only consists |
||
| 36 | of raising to the locks TPL. |
||
| 37 | |||
| 38 | Note on a debug build the lock is acquired and released |
||
| 39 | to help ensure proper usage. |
||
| 40 | |||
| 41 | Arguments: |
||
| 42 | |||
| 43 | Lock - The FLOCK structure to initialize |
||
| 44 | |||
| 45 | Priority - The task priority level of the lock |
||
| 46 | |||
| 47 | |||
| 48 | Returns: |
||
| 49 | |||
| 50 | An initialized F Lock structure. |
||
| 51 | |||
| 52 | --*/ |
||
| 53 | { |
||
| 54 | Lock->Tpl = Priority; |
||
| 55 | Lock->OwnerTpl = 0; |
||
| 56 | Lock->Lock = 0; |
||
| 57 | } |
||
| 58 | |||
| 59 | |||
| 60 | VOID |
||
| 61 | AcquireLock ( |
||
| 62 | IN FLOCK *Lock |
||
| 63 | ) |
||
| 64 | /*++ |
||
| 65 | |||
| 66 | Routine Description: |
||
| 67 | |||
| 68 | Raising to the task priority level of the mutual exclusion |
||
| 69 | lock, and then acquires ownership of the lock. |
||
| 70 | |||
| 71 | Arguments: |
||
| 72 | |||
| 73 | Lock - The lock to acquire |
||
| 74 | |||
| 75 | Returns: |
||
| 76 | |||
| 77 | Lock owned |
||
| 78 | |||
| 79 | --*/ |
||
| 80 | { |
||
| 81 | RtAcquireLock (Lock); |
||
| 82 | } |
||
| 83 | |||
| 84 | |||
| 85 | VOID |
||
| 86 | ReleaseLock ( |
||
| 87 | IN FLOCK *Lock |
||
| 88 | ) |
||
| 89 | /*++ |
||
| 90 | |||
| 91 | Routine Description: |
||
| 92 | |||
| 93 | Releases ownership of the mutual exclusion lock, and |
||
| 94 | restores the previous task priority level. |
||
| 95 | |||
| 96 | Arguments: |
||
| 97 | |||
| 98 | Lock - The lock to release |
||
| 99 | |||
| 100 | Returns: |
||
| 101 | |||
| 102 | Lock unowned |
||
| 103 | |||
| 104 | --*/ |
||
| 105 | { |
||
| 106 | RtReleaseLock (Lock); |
||
| 107 | } |