docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Struct NetworkInterfaceUnmanagedWrapper<T>

    An unmanaged network interface that can act as a wrapper for a managed one. Use WrapToUnmanaged<T>(T) to obtain an instance. Do not create one manually.

    Implements
    INetworkInterface
    IDisposable
    Inherited Members
    ValueType.Equals(object)
    ValueType.GetHashCode()
    ValueType.ToString()
    object.Equals(object, object)
    object.GetType()
    object.ReferenceEquals(object, object)
    Namespace: Unity.Networking.Transport
    Assembly: Unity.Networking.Transport.dll
    Syntax
    public struct NetworkInterfaceUnmanagedWrapper<T> : INetworkInterface, IDisposable where T : INetworkInterface
    Type Parameters
    Name Description
    T

    Properties

    LocalEndpoint

    Gets the local endpoint that the interface will use to communicate on the network. This call only makes sense after Bind(NetworkEndpoint) has already been called, and represents the endpoint the interface is actually bound to. This property serves the same purpose as getsockname in the BSD socket world.

    Declaration
    public NetworkEndpoint LocalEndpoint { get; }
    Property Value
    Type Description
    NetworkEndpoint

    Local endpoint.

    Methods

    Bind(NetworkEndpoint)

    Binds the network interface to an endpoint. This is meant to act the same way as the bind call in the BSD socket world. One way to see it is that it "attaches" the network interface to a specific local address on the machine.

    Declaration
    public int Bind(NetworkEndpoint endpoint)
    Parameters
    Type Name Description
    NetworkEndpoint endpoint

    Endpoint to bind to.

    Returns
    Type Description
    int

    0 on success, a negative number on error.

    Dispose()

    Declaration
    public void Dispose()

    Initialize(ref NetworkSettings, ref int)

    Initialize the network interface with the given settings.

    Declaration
    public int Initialize(ref NetworkSettings settings, ref int packetPadding)
    Parameters
    Type Name Description
    NetworkSettings settings

    Configuration settings provided to the driver.

    int packetPadding

    Return value parameter for how much padding the interface adds to packets. Note that this parameter is only concerned about padding that would be added directly in the packets stored in the send and receive queues, not to padding that would be added by lower levels of the network stack (e.g. IP headers).

    Returns
    Type Description
    int

    0 on success, a negative number on error.

    Listen()

    Start listening for incoming connections. Unlike Bind(NetworkEndpoint) which will always be called on clients and servers, this is only meant to be called on servers.

    Declaration
    public int Listen()
    Returns
    Type Description
    int

    0 on success, a negative number on error.

    ScheduleReceive(ref ReceiveJobArguments, JobHandle)

    Schedule a receive job. This job's responsibility is to read data from the network and enqueue it in ReceiveQueue.

    Declaration
    public JobHandle ScheduleReceive(ref ReceiveJobArguments receiveJobArguments, JobHandle dep)
    Parameters
    Type Name Description
    ReceiveJobArguments receiveJobArguments
    JobHandle dep

    Handle to any dependency the receive job has (use default if none).

    Returns
    Type Description
    JobHandle

    Handle to the newly-schedule job.

    ScheduleSend(ref SendJobArguments, JobHandle)

    Schedule a send job. This job's responsibility is to flush any data stored in SendQueue to the network.

    Declaration
    public JobHandle ScheduleSend(ref SendJobArguments sendJobArguments, JobHandle dep)
    Parameters
    Type Name Description
    SendJobArguments sendJobArguments
    JobHandle dep

    Handle to any dependency the send job has (use default if none).

    Returns
    Type Description
    JobHandle

    Handle to the newly-schedule job.

    Implements

    INetworkInterface
    IDisposable

    Extension Methods

    ManagedNetworkInterfaceExtensions.WrapToUnmanaged<T>(T)
    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)