6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/** @file
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * VBox Host Guest Shared Memory Interface (HGSMI).
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Host/Guest shared part.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/*
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync * Copyright (C) 2006-2015 Oracle Corporation
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * available from http://www.virtualbox.org. This file is free software;
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * you can redistribute it and/or modify it under the terms of the GNU
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * General Public License (GPL) as published by the Free Software
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync *
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * The contents of this file may alternatively be used under the terms
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * of the Common Development and Distribution License Version 1.0
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * VirtualBox OSE distribution, in which case the provisions of the
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * CDDL are applicable instead of those of the GPL.
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync *
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * You may elect to license modified versions of this file under the
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * terms and conditions of either the GPL or the CDDL or both.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync#ifndef ___VBox_HGSMI_HGSMI_h
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync#define ___VBox_HGSMI_HGSMI_h
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#include <iprt/assert.h>
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#include <iprt/types.h>
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
47355efb636d69b667c1cef0f2fe826569b991b0vboxsync#include <VBox/HGSMI/HGSMIDefs.h>
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#include <VBox/HGSMI/HGSMIChannels.h>
32b1164f35483be483177be7b5235002a4a5afbevboxsync#include <VBox/HGSMI/HGSMIMemAlloc.h>
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/*
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Basic mechanism for the HGSMI is to prepare and pass data buffer to the host and the guest.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Data inside these buffers are opaque for the HGSMI and are interpreted by higher levels.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Every shared memory buffer passed between the guest/host has the following structure:
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * HGSMIBUFFERHEADER header;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * uint8_t data[header.u32BufferSize];
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * HGSMIBUFFERTAIL tail;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Note: Offset of the 'header' in the memory is used for virtual hardware IO.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Buffers are verifyed using the offset and the content of the header and the tail,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * which are constant during a call.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Invalid buffers are ignored.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Actual 'data' is not verifyed, as it is expected that the data can be changed by the
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * called function.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Since only the offset of the buffer is passed in a IO operation, the header and tail
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * must contain:
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * size of data in this buffer;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * checksum for buffer verification.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * For segmented transfers:
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * the sequence identifier;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * offset of the current segment in the sequence;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * total bytes in the transfer.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync *
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * Additionally contains:
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * the channel ID;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * * the channel information.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsync/* Heap types. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync#define HGSMI_HEAP_TYPE_NULL 0 /* Heap not initialized. */
6c28ed70192c3f2d1edf978697ff0ee0276bf0eevboxsync#define HGSMI_HEAP_TYPE_POINTER 1 /* Deprecated. RTHEAPSIMPLE. */
6c28ed70192c3f2d1edf978697ff0ee0276bf0eevboxsync#define HGSMI_HEAP_TYPE_OFFSET 2 /* Deprecated. RTHEAPOFFSET. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync#define HGSMI_HEAP_TYPE_MA 3 /* Memory allocator. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#pragma pack(1)
32b1164f35483be483177be7b5235002a4a5afbevboxsynctypedef struct HGSMIHEAP
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync union
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync {
32b1164f35483be483177be7b5235002a4a5afbevboxsync HGSMIMADATA ma; /* Memory Allocator */
32b1164f35483be483177be7b5235002a4a5afbevboxsync RTHEAPSIMPLE hPtr; /* Pointer based heap. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync RTHEAPOFFSET hOff; /* Offset based heap. */
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync } u;
32b1164f35483be483177be7b5235002a4a5afbevboxsync HGSMIAREA area; /* Description. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync int cRefs; /* Number of heap allocations. */
32b1164f35483be483177be7b5235002a4a5afbevboxsync uint32_t u32HeapType; /* HGSMI_HEAP_TYPE_* */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync} HGSMIHEAP;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#pragma pack()
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#pragma pack(1)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/* The size of the array of channels. Array indexes are uint8_t. Note: the value must not be changed. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#define HGSMI_NUMBER_OF_CHANNELS 0x100
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/* Channel handler called when the guest submits a buffer. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsynctypedef DECLCALLBACK(int) FNHGSMICHANNELHANDLER(void *pvHandler, uint16_t u16ChannelInfo, void *pvBuffer, HGSMISIZE cbBuffer);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsynctypedef FNHGSMICHANNELHANDLER *PFNHGSMICHANNELHANDLER;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/* Information about a handler: pfn + context. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsynctypedef struct _HGSMICHANNELHANDLER
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync PFNHGSMICHANNELHANDLER pfnHandler;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync void *pvHandler;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync} HGSMICHANNELHANDLER;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync/* Channel description. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsynctypedef struct _HGSMICHANNEL
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMICHANNELHANDLER handler; /* The channel handler. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync const char *pszName; /* NULL for hardcoded channels or RTStrDup'ed name. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint8_t u8Channel; /* The channel id, equal to the channel index in the array. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint8_t u8Flags; /* HGSMI_CH_F_* */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync} HGSMICHANNEL;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsynctypedef struct _HGSMICHANNELINFO
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMICHANNEL Channels[HGSMI_NUMBER_OF_CHANNELS]; /* Channel handlers indexed by the channel id.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync * The array is accessed under the instance lock.
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync} HGSMICHANNELINFO;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync#pragma pack()
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncRT_C_DECLS_BEGIN
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncDECLINLINE(HGSMIBUFFERHEADER *) HGSMIBufferHeaderFromPtr(void *pvBuffer)
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync{
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync return (HGSMIBUFFERHEADER *)pvBuffer;
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync}
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncDECLINLINE(uint8_t *) HGSMIBufferDataFromPtr(void *pvBuffer)
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync{
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync return (uint8_t *)pvBuffer + sizeof(HGSMIBUFFERHEADER);
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync}
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncDECLINLINE(HGSMIBUFFERTAIL *) HGSMIBufferTailFromPtr(void *pvBuffer, uint32_t u32DataSize)
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync{
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync return (HGSMIBUFFERTAIL *)(HGSMIBufferDataFromPtr(pvBuffer) + u32DataSize);
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync}
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMISIZE) HGSMIBufferMinimumSize (void)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return sizeof (HGSMIBUFFERHEADER) + sizeof (HGSMIBUFFERTAIL);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(uint8_t *) HGSMIBufferData (const HGSMIBUFFERHEADER *pHeader)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return (uint8_t *)pHeader + sizeof (HGSMIBUFFERHEADER);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMIBUFFERTAIL *) HGSMIBufferTail (const HGSMIBUFFERHEADER *pHeader)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return (HGSMIBUFFERTAIL *)(HGSMIBufferData (pHeader) + pHeader->u32DataSize);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMIBUFFERHEADER *) HGSMIBufferHeaderFromData (const void *pvData)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return (HGSMIBUFFERHEADER *)((uint8_t *)pvData - sizeof (HGSMIBUFFERHEADER));
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMISIZE) HGSMIBufferRequiredSize (uint32_t u32DataSize)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return HGSMIBufferMinimumSize () + u32DataSize;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsyncDECLINLINE(HGSMIOFFSET) HGSMIPointerToOffset(const HGSMIAREA *pArea,
32b1164f35483be483177be7b5235002a4a5afbevboxsync const void *pv)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync return pArea->offBase + (HGSMIOFFSET)((uint8_t *)pv - pArea->pu8Base);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsyncDECLINLINE(void *) HGSMIOffsetToPointer(const HGSMIAREA *pArea,
32b1164f35483be483177be7b5235002a4a5afbevboxsync HGSMIOFFSET offBuffer)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync return pArea->pu8Base + (offBuffer - pArea->offBase);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(uint8_t *) HGSMIBufferDataFromOffset (const HGSMIAREA *pArea, HGSMIOFFSET offBuffer)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync HGSMIBUFFERHEADER *pHeader = (HGSMIBUFFERHEADER *)HGSMIOffsetToPointer(pArea, offBuffer);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync Assert(pHeader);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync if(pHeader)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return HGSMIBufferData(pHeader);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return NULL;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
85e5ab5adbba74b522731762dd05ca88cb529140vboxsyncDECLINLINE(uint8_t *) HGSMIBufferDataAndChInfoFromOffset (const HGSMIAREA *pArea, HGSMIOFFSET offBuffer, uint16_t * pChInfo)
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync HGSMIBUFFERHEADER *pHeader = (HGSMIBUFFERHEADER *)HGSMIOffsetToPointer (pArea, offBuffer);
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync Assert(pHeader);
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync if(pHeader)
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync {
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync *pChInfo = pHeader->u16ChannelInfo;
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync return HGSMIBufferData(pHeader);
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync }
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync return NULL;
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync}
85e5ab5adbba74b522731762dd05ca88cb529140vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncuint32_t HGSMIChecksum (HGSMIOFFSET offBuffer,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync const HGSMIBUFFERHEADER *pHeader,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync const HGSMIBUFFERTAIL *pTail);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncint HGSMIAreaInitialize (HGSMIAREA *pArea,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync void *pvBase,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMISIZE cbArea,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMIOFFSET offBase);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncvoid HGSMIAreaClear (HGSMIAREA *pArea);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsyncDECLINLINE(bool) HGSMIAreaContainsOffset(const HGSMIAREA *pArea, HGSMIOFFSET off)
32b1164f35483be483177be7b5235002a4a5afbevboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync return off >= pArea->offBase && off - pArea->offBase < pArea->cbArea;
32b1164f35483be483177be7b5235002a4a5afbevboxsync}
32b1164f35483be483177be7b5235002a4a5afbevboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsyncDECLINLINE(bool) HGSMIAreaContainsPointer(const HGSMIAREA *pArea, const void *pv)
974de75a5a0c1d17919acfe706ebd403d9dcc440vboxsync{
32b1164f35483be483177be7b5235002a4a5afbevboxsync return (uintptr_t)pv >= (uintptr_t)pArea->pu8Base && (uintptr_t)pv - (uintptr_t)pArea->pu8Base < pArea->cbArea;
974de75a5a0c1d17919acfe706ebd403d9dcc440vboxsync}
974de75a5a0c1d17919acfe706ebd403d9dcc440vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncHGSMIOFFSET HGSMIBufferInitializeSingle (const HGSMIAREA *pArea,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMIBUFFERHEADER *pHeader,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMISIZE cbBuffer,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint8_t u8Channel,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint16_t u16ChannelInfo);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncint HGSMIHeapSetup (HGSMIHEAP *pHeap,
32b1164f35483be483177be7b5235002a4a5afbevboxsync uint32_t u32HeapType,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync void *pvBase,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMISIZE cbArea,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMIOFFSET offBase,
32b1164f35483be483177be7b5235002a4a5afbevboxsync const HGSMIENV *pEnv);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncint HGSMIHeapRelocate (HGSMIHEAP *pHeap,
32b1164f35483be483177be7b5235002a4a5afbevboxsync uint32_t u32HeapType,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync void *pvBase,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync uint32_t offHeapHandle,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync uintptr_t offDelta,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMISIZE cbArea,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMIOFFSET offBase);
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsyncint HGSMIHeapRestoreMA(HGSMIHEAP *pHeap,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync void *pvBase,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMISIZE cbArea,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMIOFFSET offBase,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync uint32_t cBlocks,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMIOFFSET *paDescriptors,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMISIZE cbMaxBlock,
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMIENV *pEnv);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
32b1164f35483be483177be7b5235002a4a5afbevboxsyncvoid HGSMIHeapSetupUninitialized (HGSMIHEAP *pHeap);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncvoid HGSMIHeapDestroy (HGSMIHEAP *pHeap);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsyncvoid* HGSMIHeapBufferAlloc (HGSMIHEAP *pHeap,
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsync HGSMISIZE cbBuffer);
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsync
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsyncvoid HGSMIHeapBufferFree(HGSMIHEAP *pHeap,
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsync void *pvBuf);
d0a71f63bd810b54e0359223fe53b07730154dc5vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncvoid *HGSMIHeapAlloc (HGSMIHEAP *pHeap,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync HGSMISIZE cbData,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint8_t u8Channel,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync uint16_t u16ChannelInfo);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncHGSMIOFFSET HGSMIHeapBufferOffset (HGSMIHEAP *pHeap,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync void *pvData);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncvoid HGSMIHeapFree (HGSMIHEAP *pHeap,
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync void *pvData);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMIOFFSET) HGSMIHeapOffset(HGSMIHEAP *pHeap)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return pHeap->area.offBase;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync#ifdef IN_RING3
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync/* Needed for heap relocation: offset of the heap handle relative to the start of heap area. */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMIOFFSET) HGSMIHeapHandleLocationOffset(HGSMIHEAP *pHeap)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync HGSMIOFFSET offHeapHandle;
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync if (pHeap->u32HeapType == HGSMI_HEAP_TYPE_POINTER)
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync {
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync offHeapHandle = (HGSMIOFFSET)((uintptr_t)pHeap->u.hPtr - (uintptr_t)pHeap->area.pu8Base);
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync }
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync else if (pHeap->u32HeapType == HGSMI_HEAP_TYPE_OFFSET)
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync {
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync offHeapHandle = (HGSMIOFFSET)((uintptr_t)pHeap->u.hOff - (uintptr_t)pHeap->area.pu8Base);
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync }
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync else
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync {
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync offHeapHandle = HGSMIOFFSET_VOID;
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync }
8b2529a5ddb7e6170c5ab2399a8fc4ef102f8e3dvboxsync return offHeapHandle;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync#endif /* IN_RING3 */
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncDECLINLINE(HGSMISIZE) HGSMIHeapSize(HGSMIHEAP *pHeap)
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync{
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync return pHeap->area.cbArea;
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync}
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncHGSMICHANNEL *HGSMIChannelFindById(HGSMICHANNELINFO *pChannelInfo,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync uint8_t u8Channel);
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncint HGSMIChannelRegister(HGSMICHANNELINFO *pChannelInfo,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync uint8_t u8Channel,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync const char *pszName,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync PFNHGSMICHANNELHANDLER pfnChannelHandler,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync void *pvChannelHandler);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsyncint HGSMIBufferProcess(HGSMIAREA *pArea,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync HGSMICHANNELINFO *pChannelInfo,
dfc68b62b28c82701524c03873d326a99ebaa6cfvboxsync HGSMIOFFSET offBuffer);
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsyncRT_C_DECLS_END
6a97c5c107ea1c9935054f25a4fb5ca59a214b72vboxsync
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync#endif /* !___VBox_HGSMI_HGSMI_h */
7420e5ee5565b181c144eabb14da0da9e8cce657vboxsync