GenericPlatformHostSocket.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
 
#pragma once
 
#include "CoreTypes.h"
#include "Templates/SharedPointer.h"
 
 
 
class IPlatformHostSocket
{
public:
 
    enum class EResultNet : uint8
    {
        Ok,                         // Communication successful.
        ErrorUnknown,               // Unknown error.
        ErrorInvalidArgument,       // Incorrect parameters provided to a function (shouldn't happen assuming the socket object is valid).
        ErrorInvalidConnection,     // Incorrect socket id used (shouldn't happen assuming the socket object is valid).
        ErrorInterrupted,           // Data transfer interrupted e.g. a networking issue.
        ErrorHostNotConnected       // Host PC is not connected (not connected yet or has already disconnected).
    };
 
    enum class EConnectionState : uint8
    {
        Unknown,        // Default state (shouldn't be returned).
        Created,        // Socket has been created by cannot communicate yet (no host pc connected yet).
        Connected,      // Socket ready for communication.
        Disconnected,   // Host PC has disconnected (no communication possible, socket should be closed).
        Closed,         // Socket has already been closed and shouldn't be used.
    };
 
    enum class EReceiveFlags : uint8
    {
        DontWait,       // Read as much there is on the wire up to the buffer size
        WaitAll,        // Block read and wait until the buffer is filled
    };
 
public:
 
    virtual EResultNet Send(const void* Buffer, uint64 BytesToSend) = 0;
 
    virtual EResultNet Receive(void* Buffer, uint64 BytesToReceive) = 0;
 
    virtual EResultNet Receive(void* Buffer, uint64 BytesToReceive, uint64& BytesReceived, EReceiveFlags ReadMode = EReceiveFlags::WaitAll) = 0;
 
    virtual EConnectionState GetState() const = 0;
 
    virtual ~IPlatformHostSocket()
    {
    }
};
 
 
// Type definition for shared references to instances of IPlatformHostSocket.
typedef TSharedRef<IPlatformHostSocket, ESPMode::ThreadSafe> IPlatformHostSocketRef;
 
// Type definition for shared pointers to instances of IPlatformHostSocket.
typedef TSharedPtr<IPlatformHostSocket, ESPMode::ThreadSafe> IPlatformHostSocketPtr;