Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
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.h

Input Parameters

Name

Type

Description

srctask

const VSLConvTaskPtr for vslConvCopyTask

const VSLCorrTaskPtr for vslCorrCopyTask

Pointer to the source task descriptor.

Output Parameters

Name

Type

Description

newtask

VSLConvTaskPtr* for vslConvCopyTask

VSLCorrTaskPtr* for vslCorrCopyTask

Pointer to the new task descriptor.

status

int

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.