Developer Reference

Contents

AES_CMACInit

Initializes user-supplied memory as
IppsAES_CMACState
context for future use.

Syntax

IppStatus ippsAES_CMACInit(const Ipp8u*
pKey
, int
keyLen
, IppsAES_CMACState*
pState
, int
ctxSize
);
Include Files
ippcp.h
Parameters
pKey
Pointer to the AES key.
keyLen
Key bytestream length (in bytes) defined by the
IppsAESKeyLength
enumerator.
pState
Pointer to the memory buffer being initialized as
IppsAES_CMACState
context.
ctxSize
Available size of the buffer.
Description
This function initializes the memory at the address of
pState
as the
IppsAES_CMACState
context. In addition, the function uses the key to provide all necessary key material for both encryption and decryption operations.
If the
pKey
pointer is
NULL
, the function initializes the context with the zero key, which can help you to clean up the actual secret before releasing the context.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if the
pState
pointer is
NULL
.
ippStsLengthErr
Indicates an error condition if
keyLen
is not equal to 16, 24, or 32.
ippStsMemAllocErr
Indicates an error condition if the allocated memory is insufficient for the operation.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.