Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 3/31/2023
Public

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

Document Table of Contents

DftiCopyDescriptor

Makes a copy of an existing descriptor.

Syntax

status = DftiCopyDescriptor( desc_handle_original, desc_handle_copy )

Include Files
  • mkl_dfti.f90
Input Parameters

Name

Type

Description

desc_handle_original

DESCRIPTOR_HANDLE

The FFT descriptor to copy.

DESCRIPTOR_HANDLE

The FFT descriptor to copy.

Output Parameters

Name

Type

Description

dfti_handle_dst

DESCRIPTOR_HANDLE

The copy of the FFT descriptor.

status

INTEGER

Function completion status.

Description

This function makes a copy of an existing descriptor. The resulting descriptor desc_handle_copy and the existing descriptor desc_handle_original specify the same configuration of the transform, but do not have any memory areas in common ("deep copy").

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

Interface
 
INTERFACE DftiCopyDescriptor
! 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_2( Desc_Handle_Original,
 Desc_Handle_Copy )
 INTEGER :: some_actual_function_2
 TYPE(DFTI_DESCRIPTOR), POINTER :: Desc_Handle_Original, Desc_Handle_Copy
 END FUNCTION some_actual_function_2
END INTERFACE DftiCopyDescriptor