(Page 4 of 6 in this chapter) Version
TxVpdDisable
Description:
- This function issues a virtual port disable request for the virtual port identified by cpkey.
Prototype:
- short TxVpdDisable (TX_HANDLE handle,
void *userkey,
unsigned long cpkey,
TXVPD_DPR_REQ *dprreq );
- handle TX_HANDLE returned from cpi_open.
- userkey User-specified key (becomes vpdatchkey).
- cpkey Communications processor-specified key returned on successful attach.
- dprreq Dual port RAM packet to be initialized and issued.
Details
- A virtual port is disabled to deactivate data transfer. Any transmit requests that are pending are terminated (returning with a failure response) and receive indications stop.
- The response to the disable request is generated after all outstanding data transfers complete.This allows an application to use the disable response as an indication that the virtual port will produce no further dual port RAM packets. During the interval between the disable request and the receipt of the disable response, you can receive both successful and failed transmit/receive packets. Applications must be coded to expect these packets until the disable response is received.
Note: If other enabled virtual ports are sharing the same resource, the disable has no effect on the physical port. Only the last disable will actually bring down the port.
See Also
- TxVpdDetach, TxVpdEnable
(Page 4 of 6 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights
reserved.