DftiFreeDescriptor

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 12/16/2022

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-2CA4889C-D4AC-45DF-A39F-B54B05FDFD56

View Details

DftiFreeDescriptor

Frees the memory allocated for a descriptor.

Syntax

status = DftiFreeDescriptor( desc_handle )

Include Files

mkl_dfti.f90

Input Parameters

Name	Type	Description
desc_handle	DESCRIPTOR_HANDLE	FFT descriptor.

Output Parameters

Name	Type	Description
desc_handle	DESCRIPTOR_HANDLE	Memory for the FFT descriptor is released.
status	INTEGER	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 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 Functions on 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.

Interface

 
INTERFACE DftiFreeDescriptor
//Note that the body provided here is to illustrate the different
//argument list and types of dummy arguments. The interface
//does not guarantee what the actual function names are.
//Users can only rely on the function name following the
//keyword INTERFACE
 FUNCTION some_actual_function_3( Desc_Handle )
 INTEGER :: some_actual_function_3
 TYPE(DFTI_DESCRIPTOR), POINTER :: Desc_Handle
 END FUNCTION some_actual_function_3
END INTERFACE DftiFreeDescriptor

Parent topic: FFT Descriptor Manipulation Functions

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

DftiFreeDescriptor