Ring1_Memory_zeroFillArray
Zero a memory block.
Ring1_Result
Ring1_Memory_zeroFillArray
(
void *p,
size_t numberOfElements,
size_t elementSize
)
This function assignes the value zero to the first numberOfElements * elementSize
Bytes of the memory block pointed to by
p
. In particular, this function fails if the product of numberOfElements * elementSize
would overflow.
Parameter variables
p
- A pointer to a memory block of
n
Bytes. numberOfElements, elementSize
- The product
numberOfElements, elementSize
the number of Bytes.
Return Values
Ring1_Result_Success
on success, Ring1_Result_Failure
on failure.
Post Conditions
If this function fails, then it sets the by-thread status variable.
Below is a list of failure conditions and the status codes indicating them.
Ring1_Status_InvalidArgument
p
isNULL
Ring1_Status_NumericOverflow
numberOfElements * elementSize
overflows
If this function fails, p
is not dereferenced.