Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 7/13/2023
Public

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

Document Table of Contents

vslConvCopyTask/vslCorrCopyTask

Copies a descriptor for convolution or correlation task.

Syntax

status = vslconvcopytask(newtask, srctask)

status = vslcorrcopytask(newtask, srctask)

Include Files

  • mkl.fi, mkl_vsl.f90

Input Parameters

Name

Type

Description

srctask

INTEGER*4 srctask(2) for vslcorrcopytask

TYPE(VSL_CONV_TASK) for vslconvcopytask

TYPE(VSL_CORR_TASK) for vslcorrcopytask

Pointer to the source task descriptor.

Output Parameters

Name

Type

Description

newtask

INTEGER*4 srctask(2) for vslcorrcopytask

TYPE(VSL_CONV_TASK) for vslconvcopytask

TYPE(VSL_CORR_TASK) for vslcorrcopytask

Pointer to the new task descriptor.

status

INTEGER

Current status of the source task.

Description

If a task object srctask already exists, you can use an appropriate vslConvCopyTask/vslCorrCopyTask routine to make its copy in newtask. After the copy operation, both source and new task objects will become committed (see Introduction to Convolution and Correlation for information about task commitment). If the source task was not previously committed, the commitment operation for this task is implicitly invoked before copying starts. If an error occurs during source task commitment, the task stores the error code in the status field. If an error occurs during copy operation, the routine returns a NULL pointer instead of a reference to a new task object.