<!--
{
  "availability" : [
    "DriverKit: -"
  ],
  "documentType" : "symbol",
  "framework" : "SCSIControllerDriverKit",
  "identifier" : "/documentation/SCSIControllerDriverKit/IOUserSCSIParallelInterfaceController/UserSetHBAProperties",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SCSIControllerDriverKit"
    ],
    "preciseIdentifier" : "c:@S@IOUserSCSIParallelInterfaceController@F@UserSetHBAProperties#*$@S@OSDictionary#"
  },
  "title" : "UserSetHBAProperties"
}
-->

# UserSetHBAProperties

Sets multiple properties for a host bus adapter.

```
virtual kern_return_t UserSetHBAProperties(OSDictionary *properties);
```

## Parameters

`properties`

A dictionary containing key-value pairs of properties.

## Return Value

A value that indicates the result of setting the properties. <doc://com.apple.documentation/documentation/DriverKit/kIOReturnSuccess> indicates success. For error definitions, see <doc://com.apple.documentation/documentation/iokit/iokit_constants>.

## Discussion

Your driver extension calls this method to set properties on the HBA. The `properties` directory can contain the following keys:

- <doc://com.apple.documentation/documentation/iokit/kiopropertyvendornamekey>
- <doc://com.apple.documentation/documentation/iokit/kiopropertyproductnamekey>
- <doc://com.apple.documentation/documentation/iokit/kiopropertyproductrevisionlevelkey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyportdescriptionkey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyportspeedkey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyporttopologykey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyscsiparallelsignalingtypekey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyfibrechannelcabledescriptionkey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyfibrechannelnodeworldwidenamekey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyfibrechannelportworldwidenamekey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyfibrechanneladdressidentifierkey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertyfibrechannelalpakey>
- <doc://com.apple.documentation/documentation/kernel/kiopropertysasaddresskey>

The value of each property should be a pointer to a valid <doc://com.apple.documentation/documentation/DriverKit/OSString> object that represents the value for the property. The value must be of the proper type and size for the specified key.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)