aclrtSetStreamConfigOpt

Applicability

Product

Supported

Atlas A3 training products/Atlas A3 inference products

x

Atlas A2 training products/Atlas A2 inference products

x

Atlas 200I/500 A2 inference products

x

Atlas inference products

x

Atlas training products

x

Description

Sets the value of each attribute in the stream configuration object.

This API must be used together with other APIs to create a stream. The API call sequence is as follows:
  1. Call aclrtCreateStreamConfigHandle to create a stream configuration object.
  2. Call aclrtSetStreamConfigOpt multiple times to set the value of each attribute in the configuration object.
  3. Call aclrtCreateStreamV2 to create a stream.
  4. After the stream is used, call aclrtDestroyStreamConfigHandle to destroy the stream configuration object and call aclrtDestroyStream to destroy the stream.

Prototype

aclError aclrtSetStreamConfigOpt(aclrtStreamConfigHandle *handle, aclrtStreamConfigAttr attr, const void *attrValue, size_t valueSize)

Parameters

Parameter

Input/Output

Description

handle

Output

Pointer to the stream configuration object. Call aclrtCreateStreamConfigHandle to create an object in advance.

attr

Input

Attribute to set.

attrValue

Input

Pointer to the attr value to set.

If the attribute value itself is a pointer, pass the address of the pointer.

valueSize

Input

Data length of attrValue.

You can use the sizeof(*attrValue) function in the C/C++ standard library to query the data length.

Returns

0 on success; else, failure. For details, see aclError.