Showing changes from revision #1 to #2:
Added | Removed | Changed
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 |
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.