Intel® oneAPI Math Kernel Library Developer Reference - C

DftiFreeDescriptor

Frees the memory allocated for a descriptor.

Syntax

status = DftiFreeDescriptor(&desc_handle);

Include Files

Input Parameters

Name

Type

Description

desc_handle

DFTI_DESCRIPTOR_HANDLE

FFT descriptor.

Output Parameters

Name

Type

Description

desc_handle

DFTI_DESCRIPTOR_HANDLE

Memory for the FFT descriptor is released.

status

MKL_LONG

Function completion status.

Description

This function frees all memory allocated for a descriptor.

Note

Memory allocation/deallocation inside Intel® oneAPI Math Kernel Library is managed by Intel® oneAPI Math Kernel Library memory management software. So, even after successful completion ofFreeDescriptor, the memory space may continue being allocated for the application because the memory management software sometimes does not return the memory space to the OS, but considers the space free and can reuse it for future memory allocation. See Example mkl_free_buffers: Usage with FFT Functionson how to use Intel® oneAPI Math Kernel Library memory management software and release memory to the OS.

The function returns zero when it completes successfully. See Status Checking Functions for more information on the returned status.

Prototype

 
MKL_LONG DftiFreeDescriptor( DFTI_DESCRIPTOR_HANDLE * );