hi_mpi_pngd_create_chn
Applicable Products
|
Product |
Supported |
|---|---|
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
☓ |
Function
Creates a decoding channel based on the configured channel attributes.
Prototype
hi_s32 hi_mpi_pngd_create_chn(hi_pngd_chn chn, const hi_pngd_chn_attr *attr)
Parameters
|
Parameter |
Input/Output |
Description |
|---|---|---|
|
chn |
Input |
Decoding channel ID. The value range of this parameter is [0, 128). The maximum number of channels is 128. |
|
attr |
Input |
Pointer to the decoding channel attributes. |
Returns
- 0: success
- Other values: failure. For details, see PNGD Return Codes.
Restrictions
- The channel ID of a single device must not be greater than the maximum channel ID.
- If attr is left empty, the error code HI_ERR_PNGD_NULL_PTR is returned.
- Before this API call, ensure that a channel has not been created yet or has been destroyed. Otherwise, a failure is returned.
- If the OS memory is insufficient, the error code HI_ERR_PNGD_NO_MEM is returned. In this case, you can expand the OS memory.
- When a setting in the channel attributes pointed by attr exceeds the decoding capability set, the error code HI_ERR_PNGD_ILLEGAL_PARAM is returned.
- For Ascend virtual instances, the requirements on the number of channels are as follows:
For Ascend virtual instances on the
Atlas inference products , the restrictions on the number of channels vary with the following Ascend virtual instance templates:- When the vir04_4c_dvpp template is used, the total number of channels is fixed at 128.
- When the vir04_3c_ndvpp template is used, the DVPP function is not used. Therefore, the total number of channels is 0.
- When other templates are used, total number of channels = allocation specification × 128. If the total number of channels is not an integer, round down the value.
For Ascend virtual instances on the
Atlas inference products , the restrictions on the number of channels vary with the following Ascend virtual instance templates:- When the vir12_4c_32g_m, vir10_4c_16g_m, or vir10_4c_32g_m template is used, the total number of channels is fixed to 128.
- When the vir12_3c_32g_nm, vir10_3c_16g_nm, or vir10_3c_32g_nm template is used, the DVPP function is not used. Therefore, the total number of channels is 0.
To check the compute resource specifications of the Ascend virtual instances in different scenarios, run the npu-smi info -t template-info command on the server with the AI processor installed.