|
|
udi_nsr_bind_ack(3udi)
Network bind acknowledgment
#include <udi.h>void udi_nsr_bind_ack ( udi_nic_bind_cb_t *cb, udi_status_t status );ARGUMENTS cb is a pointer to the Network Driver bind acknowledgement control block.
status indicates the success or failure of the network bind request
TARGET CHANNEL The udi_nsr_bind_ack is issued to the NSR via the Network Interface Metalanguage bind channel over which the udi_nd_bind_req operation was received.
DESCRIPTION Handshakes udi_nd_bind_req operation to the NSR. The ND uses it to inform the NSR about the driver operational parameters and signify its readiness for network data transfer operations.
It is expected that the data transfer channels will have been fully spawned and configured before completion of the udi_nsr_bind_ack operation. The NSR will always issue the udi_channel_spawn for its end of the data transfer channels before issuing the udi_nd_bind_req operation.
The ND must use the same udi_nic_bind_cb_t obtained via the udi_nd_bind_req operation to generate the udi_nsr_bind_ack acknowledgement.
This operation causes the ND and NSR to enter the BOUND state (see Section 2.4.1, "NIC Metalanguage States").
STATUS VALUES UDI_OK indicates that the network bind operation succeeded.
UDI_STAT_INVALID_STATE indicates that the ND is already bound to another NSR and cannot satisfy this bind request.
UDI_STAT_HW_PROBLEM indicates that the driver has detected a fatal hardware problem with the enumerated device and cannot complete the bind operation successfully.