Characterizations of Kurzweil--Henstock--Pettis integrable functions