Developer Reference

  • 0.10
  • 10/21/2020
  • Public Content
Contents

DftiFreeDescriptor

Frees the memory allocated for a descriptor.

Syntax

status
=
DftiFreeDescriptor
(
&desc_handle
)
;
Include Files
  • mkl.h
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.
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 of
FreeDescriptor
, 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 * );  

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804