1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/*
* Copyright (C) 2010 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* you can redistribute it and/or modify it under the terms of the GNU
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
* VirtualBox OSE distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*/
#ifndef ___VBoxUhgsmi_h__
#define ___VBoxUhgsmi_h__
#include <iprt/cdefs.h>
#include <iprt/types.h>
typedef struct VBOXUHGSMI *PVBOXUHGSMI;
typedef struct VBOXUHGSMI_BUFFER *PVBOXUHGSMI_BUFFER;
typedef void* HVBOXUHGSMI_SYNCHOBJECT;
typedef enum
{
VBOXUHGSMI_SYNCHOBJECT_TYPE_NONE = 0,
VBOXUHGSMI_SYNCHOBJECT_TYPE_EVENT,
VBOXUHGSMI_SYNCHOBJECT_TYPE_SEMAPHORE
} VBOXUHGSMI_SYNCHOBJECT_TYPE;
typedef struct VBOXUHGSMI_BUFFER_LOCK_FLAGS
{
union
{
struct
{
uint32_t bReadOnly : 1;
uint32_t bWriteOnly : 1;
uint32_t bDonotWait : 1;
uint32_t bDiscard : 1;
uint32_t bLockEntire : 1;
uint32_t Reserved : 27;
};
uint32_t Value;
};
} VBOXUHGSMI_BUFFER_LOCK_FLAGS;
typedef struct VBOXUHGSMI_BUFFER_SUBMIT_FLAGS
{
union
{
struct
{
uint32_t bHostReadOnly : 1;
uint32_t bHostWriteOnly : 1;
uint32_t bDoNotRetire : 1; /* <- the buffer will be uset in a subsequent command */
uint32_t bDoNotSignalCompletion : 1; /* <- do not signal notification object on completion for this alloc */
uint32_t bEntireBuffer : 1;
uint32_t Reserved : 27;
};
uint32_t Value;
};
} VBOXUHGSMI_BUFFER_SUBMIT_FLAGS, *PVBOXUHGSMI_BUFFER_SUBMIT_FLAGS;
/* the caller can specify NULL as a hSynch and specify a valid enmSynchType to make UHGSMI create a proper object itself,
* */
typedef DECLCALLBACK(int) FNVBOXUHGSMI_BUFFER_CREATE(PVBOXUHGSMI pHgsmi, uint32_t cbBuf,
VBOXUHGSMI_SYNCHOBJECT_TYPE enmSynchType, HVBOXUHGSMI_SYNCHOBJECT hSynch,
PVBOXUHGSMI_BUFFER* ppBuf);
typedef FNVBOXUHGSMI_BUFFER_CREATE *PFNVBOXUHGSMI_BUFFER_CREATE;
typedef struct VBOXUHGSMI_BUFFER_SUBMIT
{
PVBOXUHGSMI_BUFFER pBuf;
uint32_t offData;
uint32_t cbData;
VBOXUHGSMI_BUFFER_SUBMIT_FLAGS fFlags;
} VBOXUHGSMI_BUFFER_SUBMIT, *PVBOXUHGSMI_BUFFER_SUBMIT;
typedef DECLCALLBACK(int) FNVBOXUHGSMI_BUFFER_SUBMIT_ASYNCH(PVBOXUHGSMI pHgsmi, PVBOXUHGSMI_BUFFER_SUBMIT aBuffers, uint32_t cBuffers);
typedef FNVBOXUHGSMI_BUFFER_SUBMIT_ASYNCH *PFNVBOXUHGSMI_BUFFER_SUBMIT_ASYNCH;
typedef DECLCALLBACK(int) FNVBOXUHGSMI_BUFFER_DESTROY(PVBOXUHGSMI_BUFFER pBuf);
typedef FNVBOXUHGSMI_BUFFER_DESTROY *PFNVBOXUHGSMI_BUFFER_DESTROY;
typedef DECLCALLBACK(int) FNVBOXUHGSMI_BUFFER_LOCK(PVBOXUHGSMI_BUFFER pBuf, uint32_t offLock, uint32_t cbLock, VBOXUHGSMI_BUFFER_LOCK_FLAGS fFlags, void**pvLock);
typedef FNVBOXUHGSMI_BUFFER_LOCK *PFNVBOXUHGSMI_BUFFER_LOCK;
typedef DECLCALLBACK(int) FNVBOXUHGSMI_BUFFER_UNLOCK(PVBOXUHGSMI_BUFFER pBuf);
typedef FNVBOXUHGSMI_BUFFER_UNLOCK *PFNVBOXUHGSMI_BUFFER_UNLOCK;
typedef struct VBOXUHGSMI
{
PFNVBOXUHGSMI_BUFFER_CREATE pfnBufferCreate;
PFNVBOXUHGSMI_BUFFER_SUBMIT_ASYNCH pfnBufferSubmitAsynch;
/* user custom data */
void *pvUserData;
} VBOXUHGSMI, *PVBOXUHGSMI;
typedef struct VBOXUHGSMI_BUFFER
{
PFNVBOXUHGSMI_BUFFER_LOCK pfnLock;
PFNVBOXUHGSMI_BUFFER_UNLOCK pfnUnlock;
PFNVBOXUHGSMI_BUFFER_DESTROY pfnDestroy;
/* r/o data added for ease of access and simplicity
* modifying it leads to unpredictable behavior */
HVBOXUHGSMI_SYNCHOBJECT hSynch;
VBOXUHGSMI_SYNCHOBJECT_TYPE enmSynchType;
uint32_t cbBuffer;
bool bSynchCreated;
/* user custom data */
void *pvUserData;
} VBOXUHGSMI_BUFFER, *PVBOXUHGSMI_BUFFER;
#endif /* #ifndef ___VBoxUhgsmi_h__ */
|