<!--
{
  "availability" : [
    "macOS: 15.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Hypervisor",
  "identifier" : "/documentation/Hypervisor/hv_gic_get_distributor_reg(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Hypervisor"
    ],
    "preciseIdentifier" : "c:@F@hv_gic_get_distributor_reg"
  },
  "title" : "hv_gic_get_distributor_reg(_:_:)"
}
-->

# hv_gic_get_distributor_reg(_:_:)

Reads a generic interrupt controller (GIC) distributor register.

```
func hv_gic_get_distributor_reg(_ reg: hv_gic_distributor_reg_t, _ value: UnsafeMutablePointer<UInt64>) -> hv_return_t
```

## Parameters

`reg`

One of the enumeration values that represents a GIC distributor register.

`value`

A pointer to the distributor register value that the framework writes to upon success.

## Return Value

[`HV_SUCCESS`](/documentation/Hypervisor/HV_SUCCESS) on success; otherwise, an error code.

## Discussion

The GIC distributor register enumeration values are equal to the device register offsets defined in the ARM GIC v3 specification. Alternatively the client can use the offset while looping through large register arrays.

---

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)