---
title: SetElementName
framework: VideoDriverKit
role: symbol
role_heading: Instance Method
platforms: [driverkit 27.0+]
path: videodriverkit/iouservideoobject/setelementname
---

# SetElementName

Sets the name for the given element and scope of the video object.

## Declaration

```occ
kern_return_t SetElementName(IOUserVideoObjectPropertyElement in_element, IOUserVideoObjectPropertyScope in_scope, OSString *in_name);
```

## Parameters

- `in_element`: The IOUserVideoObjectPropertyElement.
- `in_scope`: The IOUserVideoObjectPropertyScope.
- `in_name`: An OSString name to set.

## Return Value

Return Value A kern_return_t value indicating success or failure.

## Discussion

Discussion If the object can change the name dynamically, the object sends a notification to the host to update the object state on success. The object’s work queue synchronizes access to this value.

## See Also

### Working with elements

- [GetElementCategoryName](videodriverkit/iouservideoobject/getelementcategoryname.md)
- [SetElementCategoryName](videodriverkit/iouservideoobject/setelementcategoryname.md)
- [GetElementName](videodriverkit/iouservideoobject/getelementname.md)
- [GetElementNumberName](videodriverkit/iouservideoobject/getelementnumbername.md)
- [SetElementNumberName](videodriverkit/iouservideoobject/setelementnumbername.md)