Function

SCNetworkInterfaceCopyMediaOptions

Returns information media options for the specified network interface.

Declaration

Boolean SCNetworkInterfaceCopyMediaOptions(SCNetworkInterfaceRef interface, CFDictionaryRef  _Nullable *current, CFDictionaryRef  _Nullable *active, CFArrayRef  _Nullable *available, Boolean filter);

Parameters

interface

The network interface.

current

On output, a dictionary representing the currently requested media options (subtype, options). If NULL, the current options are not returned.

active

On output, a dictionary representing the active media options (subtype, options). If NULL, the active options are not returned.

available

On output, an array representing the possible media options (subtype, options). If NULL, the current options are not returned.

filter

A Boolean value indicating whether the available options should be filtered to exclude those options which would not normally be requested by a user/admin (for example, hw-loopback).

Return Value

TRUE if requested information has been returned.

See Also

Configuring Network Interfaces

SCNetworkInterfaceCopyAll

Returns all network-capable interfaces on the system.

SCNetworkInterfaceCopyMTU

Returns the current MTU setting and the range of allowable values for the specified network interface.

SCNetworkInterfaceCopyMediaSubTypeOptions

Returns a list of available media options for the specified interface configuration options and subtype.

SCNetworkInterfaceCopyMediaSubTypes

Returns a list of available media subtypes for the specified interface configuration options.

SCNetworkInterfaceCreateWithInterface

Creates a new network interface layered on top of the specified interface.

SCNetworkInterfaceForceConfigurationRefresh

Sends a notification to interested network configuration agents to immediately retry their configuration.

SCNetworkInterfaceGetBSDName

Returns the BSD interface or device name for the specified interface.

SCNetworkInterfaceGetConfiguration

Returns the configuration settings associated with the specified interface.

SCNetworkInterfaceGetExtendedConfiguration

Returns the extended configuration settings associated with the specified interface.

SCNetworkInterfaceGetHardwareAddressString

Returns a displayable link layer address for the specified interface.

SCNetworkInterfaceGetInterface

Returns the underlying interface, for layered network interfaces.

SCNetworkInterfaceGetInterfaceType

Returns the network interface type of the specified interface.

SCNetworkInterfaceGetLocalizedDisplayName

Returns the localized display name, such as “Ethernet” or “FireWire", for the specified interface.

SCNetworkInterfaceGetSupportedInterfaceTypes

Identifies all of the network interface types, such as PPP, that can be layered on top of the specified interface.

SCNetworkInterfaceGetSupportedProtocolTypes

Identifies all of the network protocol types, such as IPv4 and IPv6, that can be layered on top of the specified interface.

SCNetworkInterfaceGetTypeID

Returns the type identifier of all SCNetworkInterface instances.

SCNetworkInterfaceSetConfiguration

Stores the configuration settings for the specified interface.

SCNetworkInterfaceSetExtendedConfiguration

Stores the extended configuration settings for the specified interface.

SCNetworkInterfaceSetMTU

Sets the requested MTU setting for the specified network interface.

SCNetworkInterfaceSetMediaOptions

Sets the requested media subtype and options for the specified network interface.