Makes a copy of an existing descriptor.
FORTRAN:
status = DftiCopyDescriptor( desc_handle_original, desc_handle_copy )
C:
status = DftiCopyDescriptor(desc_handle_original, &desc_handle_copy);
Name |
Type |
Description |
|---|---|---|
desc_handle_original |
FORTRAN: DESCRIPTOR_HANDLE C: DFTI_DESCRIPTOR_HANDLE |
The FFT descriptor to make a copy of. |
Name |
Type |
Description |
|---|---|---|
desc_handle_copy |
FORTRAN: DESCRIPTOR_HANDLE C: DFTI_DESCRIPTOR_HANDLE |
The copy of the FFT descriptor. |
status |
FORTRAN: INTEGER C: MKL_LONG |
Function completion status. |
This function makes a copy of an existing descriptor and provides a pointer to it. The purpose is that all information of the original descriptor will be maintained even if the original is destroyed via the free descriptor function DftiFreeDescriptor.
The function returns the zero status when it completes successfully. See Status Checking Functions for more information on the returned status.
! Fortran 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
/* C prototype */ MKL_LONG DftiCopyDescriptor( DFTI_DESCRIPTOR_HANLDE, DFTI_DESCRIPTOR_HANDLE * );