pm: add type for device PM control callback Add a type and documentation for the device PM control callback. This way possible return codes and its meaning are documented. Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>