A fast and easily customised operating system
for ARM devices
HAL_ExtMachineID
Hardware Abstraction Layer
HAL entry points from RISC OS
ยป HAL_ExtMachineID
HAL_ExtMachineID
(HAL entry #115)
unsigned int HAL_ExtMachineID(void *buf)
| Entry | |
|---|---|
| buf | Pointer to word-aligned buffer, or 0 to read required size |
| Exit | |
|---|---|
| - | Returns size of extended ID, or if 0 extended ID not present/corrupt |
| - | Extended ID copied to buffer, if applicable |
Use
This is an internal call for OS use only, and its specifications are subject to change without warning. User software should use OS_ReadSysInfo 12 (and friends) instead of calling this function directly.
This call allows HALs to expose their machine ID in a way that is free of the constraints of HAL_MachineID. Callers should first call with a null buffer pointer to determine the required buffer size, and then call again with a valid pointer in order to read the ID.
If a HAL provides an extended ID then there is no need for HAL_MachineID to be implemented. The kernel will instead use the extended ID to synthesise an old-style ID, for use with OS_ReadSysInfo 2/OS_ReadSysInfo 5.