Function

OSBitOrAtomic16

16-bit logical or operation, performed atomically with respect to all devices that participate in the coherency architecture of the platform.

Declaration

UInt16 OSBitOrAtomic16(UInt32 mask, volatile UInt16 *address);

Parameters

mask

The mask to logically or with the value.

address

The 2-byte aligned address of the value to update atomically.

Return Value

The value before the bitwise operation.

Discussion

The OSBitOrAtomic16 function logically ors the bits of the specified mask into the value at the specified address and returns the original value.

This function guarantees atomicity only with main system memory. It is specifically unsuitable for use on noncacheable memory such as that in devices; this function cannot guarantee atomicity, for example, on memory mapped from a PCI device. Additionally, this function incorporates a memory barrier on systems with weakly-ordered memory architectures.