Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

DftiCommitDescriptor

Performs all initialization for the actual FFT computation.

Syntax

status
=
DftiCommitDescriptor
(
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
Updated FFT descriptor.
status
MKL_LONG
Function completion status.
Description
This function completes initialization of a previously created descriptor, which is required before the descriptor can be used for FFT computations. Typically, committing the descriptor performs all initialization that is required for the actual FFT computation. The initialization done by the function may involve exploring different factorizations of the input length to find the optimal computation method.
If you call the
DftiSetValue
function to change configuration parameters of a committed descriptor , you must re-commit the descriptor before invoking a computation function. Typically, a committal function call is immediately followed by a computation function call .
The function returns zero when it completes successfully.
See Status Checking Functions for more information on the returned status.
Prototype
  MKL_LONG DftiCommitDescriptor( 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