Carbon


BlockMoveData

Header: MacMemory.h Carbon status: Supported

void BlockMoveData (
    const void *srcPtr, 
    void *destPtr, 
    Size byteCount
);
srcPtr
destPtr
byteCount
DISCUSSION

You should not make any assumptions about the state of the destination memory while BlockMoveData is executing. In the intermediate state, values may be present that are neither the original nor the final ones. For example, this function may use the 'dcbz' instruction. If the underlying memory is not cacheable, if the memory is write-through instead of copy-back, or if the cache block is flushed for some reason, the 'dcbz' instruction will write zeros to the destination. You can avoid the use of the 'dcbz' instruction by calling BlockMoveDataUncached, but even that function makes no other guarantees about the memory block's intermediate state.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when DriverServicesLib 1.0 (or later) or InterfaceLib 7.1 (or later) is installed. Exported by CarbonLib 1.0 and later, DriverServicesLib 1.0 and later, and by InterfaceLib 7.1 and later.


© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)