The next function within the device API structure is the device Stop()
function. This function is called once each time an interface is stopped.
Files
Every device driver’s net_dev.c
Prototype
Note that since every device driver’s Stop()
function is accessed only by function pointer via the device driver’s API structure, it doesn’t need to be globally available and should therefore be declared as ‘static
’.
Arguments
pif
Pointer to the interface to start a network device.
perr
Pointer to variable that will receive the return error code from this function.
Returned Value
None.
Required Configuration
None.
Notes / Warnings
The Stop()
function must perform the following operations:
NetOS_IF_DeallocTaskPost()
with the address of the transmit descriptor data areas.perr
to NET_DEV_ERR_NONE
if no error occurs. Otherwise, set perr
to an appropriate network device error code.