Contents

setLinkStatus

Reports the link status and the active medium.

Declaration

virtual bool setLinkStatus( 
 UInt32 status, 
 const IONetworkMedium *activeMedium = 0, 
 UInt64 speed = 0, 
 OSData *data = 0);

Parameters

  • status:

    Link status bits. See IONetworkMedium for the definition of the link status bits.

  • activeMedium:

    An object in the published medium dictionary that represents the active medium. This may not be the same as the selected medium. Set this to 0 if the link is inactive.

  • speed:

    Link speed in units of bits per second. If zero, then the link speed is taken from the medium object provided.

  • data:

    An OSData containing any additional link parameter that the driver wishes to publish to the registry.

Return Value

Returns true if all link properties were successfully updated, false otherwise.

Overview

Drivers must call this method when a link change is detected. IONetworkController will update the link status properties in the registry, and generate an event to inform the upper layers about the change.

See Also

Miscellaneous