HGSMICommon.cpp revision 8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18
9bee881471745317e907eefbacf9ef344c74c899vboxsync/** @file
9bee881471745317e907eefbacf9ef344c74c899vboxsync *
9bee881471745317e907eefbacf9ef344c74c899vboxsync * VBox Host Guest Shared Memory Interface (HGSMI).
9bee881471745317e907eefbacf9ef344c74c899vboxsync * HGSMI functions common for both host and guest.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/*
9bee881471745317e907eefbacf9ef344c74c899vboxsync * Copyright (C) 2006-2009 Sun Microsystems, Inc.
9bee881471745317e907eefbacf9ef344c74c899vboxsync *
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 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
cf5f6bf2704d4fff443139e10bccc6a0a7fa4b85vboxsync * additional information or have any questions.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync#include <iprt/heap.h>
9bee881471745317e907eefbacf9ef344c74c899vboxsync#include <iprt/string.h>
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync#include <VBox/HGSMI/HGSMI.h>
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync//#define LOG_GROUP LOG_GROUP_HGSMI
9bee881471745317e907eefbacf9ef344c74c899vboxsync//#include <VBox/log.h>
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define Log(f) do{}while(0)
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define LogFlowFunc(f) do{}while(0)
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define LogFunc(f) do{}while(0)
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* Channel flags. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define HGSMI_CH_F_REGISTERED 0x01
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* Assertions for situations which could happen and normally must be processed properly
9bee881471745317e907eefbacf9ef344c74c899vboxsync * but must be investigated during development: guest misbehaving, etc.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync#ifdef HGSMI_STRICT
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define HGSMI_STRICT_ASSERT_FAILED() AssertFailed()
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define HGSMI_STRICT_ASSERT(expr) Assert(expr)
9bee881471745317e907eefbacf9ef344c74c899vboxsync#else
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define HGSMI_STRICT_ASSERT_FAILED() do {} while (0)
9bee881471745317e907eefbacf9ef344c74c899vboxsync#define HGSMI_STRICT_ASSERT(expr) do {} while (0)
9bee881471745317e907eefbacf9ef344c74c899vboxsync#endif /* !HGSMI_STRICT */
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* One-at-a-Time Hash from
9bee881471745317e907eefbacf9ef344c74c899vboxsync * http://www.burtleburtle.net/bob/hash/doobs.html
9bee881471745317e907eefbacf9ef344c74c899vboxsync *
9bee881471745317e907eefbacf9ef344c74c899vboxsync * ub4 one_at_a_time(char *key, ub4 len)
9bee881471745317e907eefbacf9ef344c74c899vboxsync * {
9bee881471745317e907eefbacf9ef344c74c899vboxsync * ub4 hash, i;
9bee881471745317e907eefbacf9ef344c74c899vboxsync * for (hash=0, i=0; i<len; ++i)
9bee881471745317e907eefbacf9ef344c74c899vboxsync * {
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash += key[i];
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash += (hash << 10);
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash ^= (hash >> 6);
9bee881471745317e907eefbacf9ef344c74c899vboxsync * }
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash += (hash << 3);
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash ^= (hash >> 11);
9bee881471745317e907eefbacf9ef344c74c899vboxsync * hash += (hash << 15);
9bee881471745317e907eefbacf9ef344c74c899vboxsync * return hash;
9bee881471745317e907eefbacf9ef344c74c899vboxsync * }
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic uint32_t hgsmiHashBegin (void)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync return 0;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic uint32_t hgsmiHashProcess (uint32_t hash,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const void *pvData,
9bee881471745317e907eefbacf9ef344c74c899vboxsync size_t cbData)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync const uint8_t *pu8Data = (const uint8_t *)pvData;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync while (cbData--)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash += *pu8Data++;
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash += (hash << 10);
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash ^= (hash >> 6);
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return hash;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic uint32_t hgsmiHashEnd (uint32_t hash)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash += (hash << 3);
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash ^= (hash >> 11);
9bee881471745317e907eefbacf9ef344c74c899vboxsync hash += (hash << 15);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return hash;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncuint32_t HGSMIChecksum (HGSMIOFFSET offBuffer,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERHEADER *pHeader,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERTAIL *pTail)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint32_t u32Checksum = hgsmiHashBegin ();
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync u32Checksum = hgsmiHashProcess (u32Checksum, &offBuffer, sizeof (offBuffer));
9bee881471745317e907eefbacf9ef344c74c899vboxsync u32Checksum = hgsmiHashProcess (u32Checksum, pHeader, sizeof (HGSMIBUFFERHEADER));
9bee881471745317e907eefbacf9ef344c74c899vboxsync u32Checksum = hgsmiHashProcess (u32Checksum, pTail, RT_OFFSETOF(HGSMIBUFFERTAIL, u32Checksum));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return hgsmiHashEnd (u32Checksum);
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic HGSMIOFFSET hgsmiBufferInitializeSingle (const HGSMIAREA *pArea,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERHEADER *pHeader,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint32_t u32DataSize,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t u8Channel,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint16_t u16ChannelInfo)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( !pArea
9bee881471745317e907eefbacf9ef344c74c899vboxsync || !pHeader)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return HGSMIOFFSET_VOID;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Buffer must be within the area:
9bee881471745317e907eefbacf9ef344c74c899vboxsync * * header data size do not exceed the maximum data size;
9bee881471745317e907eefbacf9ef344c74c899vboxsync * * buffer address is greater than the area base address;
9bee881471745317e907eefbacf9ef344c74c899vboxsync * * buffer address is lower than the maximum allowed for the given data size.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMISIZE cbMaximumDataSize = pArea->offLast - pArea->offBase;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( u32DataSize > cbMaximumDataSize
9bee881471745317e907eefbacf9ef344c74c899vboxsync || (uint8_t *)pHeader < pArea->pu8Base
9bee881471745317e907eefbacf9ef344c74c899vboxsync || (uint8_t *)pHeader > pArea->pu8Base + cbMaximumDataSize - u32DataSize)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return HGSMIOFFSET_VOID;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIOFFSET offBuffer = HGSMIPointerToOffset (pArea, pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeader->u8Flags = HGSMI_BUFFER_HEADER_F_SEQ_SINGLE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeader->u32DataSize = u32DataSize;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeader->u8Channel = u8Channel;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeader->u16ChannelInfo = u16ChannelInfo;
9bee881471745317e907eefbacf9ef344c74c899vboxsync memset (pHeader->u.au8Union, 0, sizeof (pHeader->u.au8Union));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERTAIL *pTail = HGSMIBufferTail (pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pTail->u32Reserved = 0;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pTail->u32Checksum = HGSMIChecksum (offBuffer, pHeader, pTail);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return offBuffer;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIAreaInitialize (HGSMIAREA *pArea, void *pvBase, HGSMISIZE cbArea, HGSMIOFFSET offBase)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t *pu8Base = (uint8_t *)pvBase;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if ( !pArea /* Check that the area: */
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync || cbArea < HGSMIBufferMinimumSize () /* Large enough. */
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync || pu8Base + cbArea < pu8Base /* No address space wrap. */
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync || offBase > UINT32_C(0xFFFFFFFF) - cbArea /* Area within the 32 bit space: offBase + cbMem <= 0xFFFFFFFF */
9bee881471745317e907eefbacf9ef344c74c899vboxsync )
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return VERR_INVALID_PARAMETER;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pArea->pu8Base = pu8Base;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pArea->offBase = offBase;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pArea->offLast = cbArea - HGSMIBufferMinimumSize () + offBase;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pArea->cbArea = cbArea;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return VINF_SUCCESS;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncvoid HGSMIAreaClear (HGSMIAREA *pArea)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pArea)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync memset (pArea, 0, sizeof (HGSMIAREA));
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* Initialize the memory buffer including its checksum.
9bee881471745317e907eefbacf9ef344c74c899vboxsync * No changes alloed to the header and the tail after that.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsyncHGSMIOFFSET HGSMIBufferInitializeSingle (const HGSMIAREA *pArea,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERHEADER *pHeader,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMISIZE cbBuffer,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t u8Channel,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint16_t u16ChannelInfo)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (cbBuffer < HGSMIBufferMinimumSize ())
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return HGSMIOFFSET_VOID;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return hgsmiBufferInitializeSingle (pArea, pHeader, cbBuffer - HGSMIBufferMinimumSize (), u8Channel, u16ChannelInfo);
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncvoid HGSMIHeapSetupUnitialized (HGSMIHEAP *pHeap)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->u.hPtr = NIL_RTHEAPSIMPLE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->cRefs = 0;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->area.cbArea = 0;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->area.offBase = HGSMIOFFSET_VOID;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->area.offLast = HGSMIOFFSET_VOID;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->area.pu8Base = 0;
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->fOffsetBased = false;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncbool HGSMIHeapIsItialized (HGSMIHEAP *pHeap)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync return pHeap->u.hPtr != NIL_RTHEAPSIMPLE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIHeapRelocate (HGSMIHEAP *pHeap,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync void *pvBase,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync uint32_t offHeapHandle,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync uintptr_t offDelta,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMISIZE cbArea,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMIOFFSET offBase,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync bool fOffsetBased
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync )
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( !pHeap
9bee881471745317e907eefbacf9ef344c74c899vboxsync || !pvBase)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return VERR_INVALID_PARAMETER;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync int rc = HGSMIAreaInitialize (&pHeap->area, pvBase, cbArea, offBase);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (RT_SUCCESS (rc))
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if (fOffsetBased)
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->u.hOff = (RTHEAPOFFSET)((uint8_t *)pvBase + offHeapHandle);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync else
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync {
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->u.hPtr = (RTHEAPSIMPLE)((uint8_t *)pvBase + offHeapHandle);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync rc = RTHeapSimpleRelocate (pHeap->u.hPtr, offDelta); AssertRC(rc);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (RT_SUCCESS (rc))
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->cRefs = 0;
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->fOffsetBased = fOffsetBased;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIAreaClear (&pHeap->area);
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIHeapSetup (HGSMIHEAP *pHeap,
9bee881471745317e907eefbacf9ef344c74c899vboxsync void *pvBase,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMISIZE cbArea,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMIOFFSET offBase,
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync bool fOffsetBased)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( !pHeap
9bee881471745317e907eefbacf9ef344c74c899vboxsync || !pvBase)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return VERR_INVALID_PARAMETER;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync int rc = HGSMIAreaInitialize (&pHeap->area, pvBase, cbArea, offBase);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (RT_SUCCESS (rc))
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if (!fOffsetBased)
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync rc = RTHeapSimpleInit (&pHeap->u.hPtr, pvBase, cbArea);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync else
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync rc = RTHeapOffsetInit (&pHeap->u.hOff, pvBase, cbArea);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (RT_SUCCESS (rc))
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->cRefs = 0;
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->fOffsetBased = fOffsetBased;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIAreaClear (&pHeap->area);
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncvoid HGSMIHeapDestroy (HGSMIHEAP *pHeap)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pHeap)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeap->u.hPtr = NIL_RTHEAPSIMPLE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIAreaClear (&pHeap->area);
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeap->cRefs = 0;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncvoid *HGSMIHeapAlloc (HGSMIHEAP *pHeap,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMISIZE cbData,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t u8Channel,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint16_t u16ChannelInfo)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if (pHeap->u.hPtr == NIL_RTHEAPSIMPLE)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync size_t cbAlloc = HGSMIBufferRequiredSize (cbData);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync HGSMIBUFFERHEADER *pHeader;
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if (!pHeap->fOffsetBased)
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeader = (HGSMIBUFFERHEADER *)RTHeapSimpleAlloc (pHeap->u.hPtr, cbAlloc, 0);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync else
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync pHeader = (HGSMIBUFFERHEADER *)RTHeapOffsetAlloc (pHeap->u.hOff, cbAlloc, 0);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (!pHeader)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync ++pHeap->cRefs;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync hgsmiBufferInitializeSingle (&pHeap->area, pHeader, cbData, u8Channel, u16ChannelInfo);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return HGSMIBufferData (pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncHGSMIOFFSET HGSMIHeapBufferOffset (HGSMIHEAP *pHeap,
9bee881471745317e907eefbacf9ef344c74c899vboxsync void *pvData)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERHEADER *pHeader = HGSMIBufferHeaderFromData (pvData);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIOFFSET offBuffer = HGSMIPointerToOffset (&pHeap->area, pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return offBuffer;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncvoid HGSMIHeapFree (HGSMIHEAP *pHeap,
9bee881471745317e907eefbacf9ef344c74c899vboxsync void *pvData)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( pvData
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync && pHeap->u.hPtr != NIL_RTHEAPSIMPLE)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERHEADER *pHeader = HGSMIBufferHeaderFromData (pvData);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync if (!pHeap->fOffsetBased)
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync RTHeapSimpleFree (pHeap->u.hPtr, pHeader);
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync else
8f1c8e96fab0c5f5a8dcabeb4e20a56a8b4cea18vboxsync RTHeapOffsetFree (pHeap->u.hOff, pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync --pHeap->cRefs;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* Verify that the given offBuffer points to a valid buffer, which is within the area.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic const HGSMIBUFFERHEADER *hgsmiVerifyBuffer (const HGSMIAREA *pArea,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIOFFSET offBuffer)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync AssertPtr(pArea);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("buffer 0x%x, area %p %x [0x%x;0x%x]\n", offBuffer, pArea->pu8Base, pArea->cbArea, pArea->offBase, pArea->offLast));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( offBuffer < pArea->offBase
9bee881471745317e907eefbacf9ef344c74c899vboxsync || offBuffer > pArea->offLast)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFunc(("offset 0x%x is outside the area [0x%x;0x%x]!!!\n", offBuffer, pArea->offBase, pArea->offLast));
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMI_STRICT_ASSERT_FAILED();
9bee881471745317e907eefbacf9ef344c74c899vboxsync return NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERHEADER *pHeader = HGSMIOffsetToPointer (pArea, offBuffer);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Quick check of the data size, it should be less than the maximum
9bee881471745317e907eefbacf9ef344c74c899vboxsync * data size for the buffer at this offset.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("datasize check: pHeader->u32DataSize = 0x%x pArea->offLast - offBuffer = 0x%x\n", pHeader->u32DataSize, pArea->offLast - offBuffer));
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pHeader->u32DataSize <= pArea->offLast - offBuffer)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIBUFFERTAIL *pTail = HGSMIBufferTail (pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* At least both pHeader and pTail structures are in the area. Check the checksum. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint32_t u32Checksum = HGSMIChecksum (offBuffer, pHeader, pTail);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("checksum check: u32Checksum = 0x%x pTail->u32Checksum = 0x%x\n", u32Checksum, pTail->u32Checksum));
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (u32Checksum == pTail->u32Checksum)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("returning %p\n", pHeader));
9bee881471745317e907eefbacf9ef344c74c899vboxsync return pHeader;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFunc(("invalid checksum 0x%x, expected 0x%x!!!\n", u32Checksum, pTail->u32Checksum));
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMI_STRICT_ASSERT_FAILED();
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFunc(("invalid data size 0x%x, maximum is 0x%x!!!\n", pHeader->u32DataSize, pArea->offLast - offBuffer));
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMI_STRICT_ASSERT_FAILED();
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("returning NULL\n"));
9bee881471745317e907eefbacf9ef344c74c899vboxsync return NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* A wrapper to safely call the handler.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIChannelHandlerCall (const HGSMICHANNELHANDLER *pHandler,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERHEADER *pHeader)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("pHandler %p, pHeader %p\n", pHandler, pHeader));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync int rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync Assert(pHandler && pHandler->pfnHandler);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if ( pHandler
9bee881471745317e907eefbacf9ef344c74c899vboxsync && pHandler->pfnHandler)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync void *pvBuffer = HGSMIBufferData (pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMISIZE cbBuffer = pHeader->u32DataSize;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync rc = pHandler->pfnHandler (pHandler->pvHandler, pHeader->u16ChannelInfo, pvBuffer, cbBuffer);
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* It is a NOOP case here. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync rc = VINF_SUCCESS;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("leave rc = %Rrc\n", rc));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/*
9bee881471745317e907eefbacf9ef344c74c899vboxsync * Process a guest buffer.
9bee881471745317e907eefbacf9ef344c74c899vboxsync * @thread EMT
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsyncstatic int hgsmiBufferProcess (const HGSMICHANNEL *pChannel,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERHEADER *pHeader)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("pChannel %p, pHeader %p\n", pChannel, pHeader));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync int rc = HGSMIChannelHandlerCall (&pChannel->handler,
9bee881471745317e907eefbacf9ef344c74c899vboxsync pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncHGSMICHANNEL *HGSMIChannelFindById (HGSMICHANNELINFO * pChannelInfo,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t u8Channel)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMICHANNEL *pChannel = &pChannelInfo->Channels[u8Channel];
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pChannel->u8Flags & HGSMI_CH_F_REGISTERED)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync return pChannel;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIBufferProcess (HGSMIAREA *pArea,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMICHANNELINFO * pChannelInfo,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMIOFFSET offBuffer)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync LogFlowFunc(("pArea %p, offBuffer 0x%x\n", pArea, offBuffer));
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync AssertPtr(pArea);
9bee881471745317e907eefbacf9ef344c74c899vboxsync AssertPtr(pChannelInfo);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync int rc = VERR_GENERAL_FAILURE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync// VM_ASSERT_EMT(pIns->pVM);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Guest has prepared a command description at 'offBuffer'. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync const HGSMIBUFFERHEADER *pHeader = hgsmiVerifyBuffer (pArea, offBuffer);
9bee881471745317e907eefbacf9ef344c74c899vboxsync Assert(pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pHeader)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Pass the command to the appropriate handler registered with this instance.
9bee881471745317e907eefbacf9ef344c74c899vboxsync * Start with the handler list head, which is the preallocated HGSMI setup channel.
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMICHANNEL *pChannel = HGSMIChannelFindById (pChannelInfo, pHeader->u8Channel);
9bee881471745317e907eefbacf9ef344c74c899vboxsync Assert(pChannel);
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (pChannel)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync hgsmiBufferProcess (pChannel, pHeader);
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMI_STRICT_ASSERT(hgsmiVerifyBuffer (pArea, offBuffer) != NULL);
9bee881471745317e907eefbacf9ef344c74c899vboxsync rc = VINF_SUCCESS;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync rc = VERR_INVALID_FUNCTION;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync else
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync rc = VERR_INVALID_HANDLE;
9bee881471745317e907eefbacf9ef344c74c899vboxsync// LogRel(("HGSMI[%s]: ignored invalid guest buffer 0x%08X!!!\n", pIns->pszName, offBuffer));
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync return rc;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync/* Register a new VBVA channel by index.
9bee881471745317e907eefbacf9ef344c74c899vboxsync *
9bee881471745317e907eefbacf9ef344c74c899vboxsync */
9bee881471745317e907eefbacf9ef344c74c899vboxsyncint HGSMIChannelRegister (HGSMICHANNELINFO * pChannelInfo,
9bee881471745317e907eefbacf9ef344c74c899vboxsync uint8_t u8Channel,
9bee881471745317e907eefbacf9ef344c74c899vboxsync const char *pszName,
9bee881471745317e907eefbacf9ef344c74c899vboxsync PFNHGSMICHANNELHANDLER pfnChannelHandler,
9bee881471745317e907eefbacf9ef344c74c899vboxsync void *pvChannelHandler,
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMICHANNELHANDLER *pOldHandler)
9bee881471745317e907eefbacf9ef344c74c899vboxsync{
9bee881471745317e907eefbacf9ef344c74c899vboxsync AssertPtrReturn(pOldHandler, VERR_INVALID_PARAMETER);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Check whether the channel is already registered. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync HGSMICHANNEL *pChannel = HGSMIChannelFindById (pChannelInfo, u8Channel);
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync if (!pChannel)
9bee881471745317e907eefbacf9ef344c74c899vboxsync {
9bee881471745317e907eefbacf9ef344c74c899vboxsync /* Channel is not yet registered. */
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel = &pChannelInfo->Channels[u8Channel];
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->u8Flags = HGSMI_CH_F_REGISTERED;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->u8Channel = u8Channel;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->handler.pfnHandler = NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->handler.pvHandler = NULL;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->pszName = pszName;
9bee881471745317e907eefbacf9ef344c74c899vboxsync }
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync *pOldHandler = pChannel->handler;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->handler.pfnHandler = pfnChannelHandler;
9bee881471745317e907eefbacf9ef344c74c899vboxsync pChannel->handler.pvHandler = pvChannelHandler;
9bee881471745317e907eefbacf9ef344c74c899vboxsync
9bee881471745317e907eefbacf9ef344c74c899vboxsync return VINF_SUCCESS;
9bee881471745317e907eefbacf9ef344c74c899vboxsync}
9bee881471745317e907eefbacf9ef344c74c899vboxsync