---
title: 函数：kernel_args_append_place_holder
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_1090.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_1090.html
indexId: 6f5c0c8e6a8258c9e2ff4d237dda61085f1d32065003acf414b633e8a862dad171
---
# 函数：kernel_args_append_place_holder

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

对于placeholder参数，调用本接口先占位，返回的是param_handle占位符。

若参数列表中有多个参数，则需按顺序追加参数。等所有参数都追加之后，可调用acl.rt.kernel_args_get_place_holder_buffer接口获取param_handle占位符指向的内存地址。


#### 函数原型

- C函数原型
  1 aclError aclrtKernelArgsAppendPlaceHolder(aclrtArgsHandle argsHandle, aclrtParamHandle *paramHandle)

- python函数
  1 param_handle, ret = acl.rt.kernel_args_append_place_holder(args_handle)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| args\_handle | int，参数列表句柄。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| param\_handle | int，参数句柄。 |
| ret | int，返回0表示成功，返回其他值表示失败。 |
