VBoxVideoGuest.h@ 46093

Last change on this file since 46093 was 45003, checked in by vboxsync, 12 years ago
Additions/x11/vboxvideo: more dependency breaking.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 12.8 KB

Line
1	/** @file
2	*
3	* VBox Host Guest Shared Memory Interface (HGSMI).
4	* OS-independent guest structures.
5	*/
6
7	/*
8	* Copyright (C) 2006-2012 Oracle Corporation
9	*
10	* This file is part of VirtualBox Open Source Edition (OSE), as
11	* available from http://www.virtualbox.org. This file is free software;
12	* you can redistribute it and/or modify it under the terms of the GNU
13	* General Public License (GPL) as published by the Free Software
14	* Foundation, in version 2 as it comes in the "COPYING" file of the
15	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
16	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
17	*
18	* The contents of this file may alternatively be used under the terms
19	* of the Common Development and Distribution License Version 1.0
20	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
21	* VirtualBox OSE distribution, in which case the provisions of the
22	* CDDL are applicable instead of those of the GPL.
23	*
24	* You may elect to license modified versions of this file under the
25	* terms and conditions of either the GPL or the CDDL or both.
26	*/
27
28
29	#ifndef __HGSMI_GUEST_h__
30	#define __HGSMI_GUEST_h__
31
32	#include <VBox/HGSMI/HGSMI.h>
33	#include <VBox/HGSMI/HGSMIChSetup.h>
34
35	#ifdef VBOX_XPDM_MINIPORT
36	RT_C_DECLS_BEGIN
37	# include "miniport.h"
38	# include "ntddvdeo.h"
39	# include <Video.h>
40	RT_C_DECLS_END
41	#elif defined VBOX_GUESTR3XORGMOD
42	# include <compiler.h>
43	#else
44	# include <iprt/asm-amd64-x86.h>
45	#endif
46
47	#ifdef VBOX_WDDM_MINIPORT
48	# include "wddm/VBoxMPShgsmi.h"
49	typedef VBOXSHGSMI HGSMIGUESTCMDHEAP;
50	# define HGSMIGUESTCMDHEAP_GET(_p) (&(_p)->Heap)
51	#else
52	typedef HGSMIHEAP HGSMIGUESTCMDHEAP;
53	# define HGSMIGUESTCMDHEAP_GET(_p) (_p)
54	#endif
55
56	RT_C_DECLS_BEGIN
57
58	/**
59	* Structure grouping the context needed for submitting commands to the host
60	* via HGSMI
61	*/
62	typedef struct HGSMIGUESTCOMMANDCONTEXT
63	{
64	/** Information about the memory heap located in VRAM from which data
65	* structures to be sent to the host are allocated. */
66	HGSMIGUESTCMDHEAP heapCtx;
67	/** The I/O port used for submitting commands to the host by writing their
68	* offsets into the heap. */
69	RTIOPORT port;
70	} HGSMIGUESTCOMMANDCONTEXT, *PHGSMIGUESTCOMMANDCONTEXT;
71
72
73	/**
74	* Structure grouping the context needed for receiving commands from the host
75	* via HGSMI
76	*/
77	typedef struct HGSMIHOSTCOMMANDCONTEXT
78	{
79	/** Information about the memory area located in VRAM in which the host
80	* places data structures to be read by the guest. */
81	HGSMIAREA areaCtx;
82	/** Convenience structure used for matching host commands to handlers. */
83	/** @todo handlers are registered individually in code rather than just
84	* passing a static structure in order to gain extra flexibility. There is
85	* currently no expected usage case for this though. Is the additional
86	* complexity really justified? */
87	HGSMICHANNELINFO channels;
88	/** Flag to indicate that one thread is currently processing the command
89	* queue. */
90	volatile bool fHostCmdProcessing;
91	/* Pointer to the VRAM location where the HGSMI host flags are kept. */
92	volatile HGSMIHOSTFLAGS *pfHostFlags;
93	/** The I/O port used for receiving commands from the host as offsets into
94	* the memory area and sending back confirmations (command completion,
95	* IRQ acknowlegement). */
96	RTIOPORT port;
97	} HGSMIHOSTCOMMANDCONTEXT, *PHGSMIHOSTCOMMANDCONTEXT;
98
99
100	/**
101	* Structure grouping the context needed for sending graphics acceleration
102	* information to the host via VBVA. Each screen has its own VBVA buffer.
103	*/
104	typedef struct VBVABUFFERCONTEXT
105	{
106	/** Offset of the buffer in the VRAM section for the screen */
107	uint32_t offVRAMBuffer;
108	/** Length of the buffer in bytes */
109	uint32_t cbBuffer;
110	/** This flag is set if we wrote to the buffer faster than the host could
111	* read it. */
112	bool fHwBufferOverflow;
113	/** The VBVA record that we are currently preparing for the host, NULL if
114	* none. */
115	struct VBVARECORD *pRecord;
116	/** Pointer to the VBVA buffer mapped into the current address space. Will
117	* be NULL if VBVA is not enabled. */
118	struct VBVABUFFER *pVBVA;
119	} VBVABUFFERCONTEXT, *PVBVABUFFERCONTEXT;
120
121	/** @name Helper functions
122	* @{ */
123	/** Write an 8-bit value to an I/O port. */
124	DECLINLINE(void) VBoxVideoCmnPortWriteUchar(RTIOPORT Port, uint8_t Value)
125	{
126	#ifdef VBOX_XPDM_MINIPORT
127	VideoPortWritePortUchar((PUCHAR)Port, Value);
128	#elif defined VBOX_GUESTR3XORGMOD
129	outb(Port, Value);
130	#else /** @todo make these explicit */
131	ASMOutU8(Port, Value);
132	#endif
133	}
134
135	/** Write a 16-bit value to an I/O port. */
136	DECLINLINE(void) VBoxVideoCmnPortWriteUshort(RTIOPORT Port, uint16_t Value)
137	{
138	#ifdef VBOX_XPDM_MINIPORT
139	VideoPortWritePortUshort((PUSHORT)Port,Value);
140	#elif defined VBOX_GUESTR3XORGMOD
141	outw(Port, Value);
142	#else
143	ASMOutU16(Port, Value);
144	#endif
145	}
146
147	/** Write a 32-bit value to an I/O port. */
148	DECLINLINE(void) VBoxVideoCmnPortWriteUlong(RTIOPORT Port, uint32_t Value)
149	{
150	#ifdef VBOX_XPDM_MINIPORT
151	VideoPortWritePortUlong((PULONG)Port,Value);
152	#elif defined VBOX_GUESTR3XORGMOD
153	outl(Port, Value);
154	#else
155	ASMOutU32(Port, Value);
156	#endif
157	}
158
159	/** Read an 8-bit value from an I/O port. */
160	DECLINLINE(uint8_t) VBoxVideoCmnPortReadUchar(RTIOPORT Port)
161	{
162	#ifdef VBOX_XPDM_MINIPORT
163	return VideoPortReadPortUchar((PUCHAR)Port);
164	#elif defined VBOX_GUESTR3XORGMOD
165	return inb(Port);
166	#else
167	return ASMInU8(Port);
168	#endif
169	}
170
171	/** Read a 16-bit value from an I/O port. */
172	DECLINLINE(uint16_t) VBoxVideoCmnPortReadUshort(RTIOPORT Port)
173	{
174	#ifdef VBOX_XPDM_MINIPORT
175	return VideoPortReadPortUshort((PUSHORT)Port);
176	#elif defined VBOX_GUESTR3XORGMOD
177	return inw(Port);
178	#else
179	return ASMInU16(Port);
180	#endif
181	}
182
183	/** Read a 32-bit value from an I/O port. */
184	DECLINLINE(uint32_t) VBoxVideoCmnPortReadUlong(RTIOPORT Port)
185	{
186	#ifdef VBOX_XPDM_MINIPORT
187	return VideoPortReadPortUlong((PULONG)Port);
188	#elif defined VBOX_GUESTR3XORGMOD
189	return inl(Port);
190	#else
191	return ASMInU32(Port);
192	#endif
193	}
194
195	/** @} */
196
197	/** @name Base HGSMI APIs
198	* @{ */
199
200	/** Acknowlege an IRQ. */
201	DECLINLINE(void) VBoxHGSMIClearIrq(PHGSMIHOSTCOMMANDCONTEXT pCtx)
202	{
203	VBoxVideoCmnPortWriteUlong(pCtx->port, HGSMIOFFSET_VOID);
204	}
205
206	RTDECL(void) VBoxHGSMIHostCmdComplete(PHGSMIHOSTCOMMANDCONTEXT pCtx,
207	void *pvMem);
208	RTDECL(void) VBoxHGSMIProcessHostQueue(PHGSMIHOSTCOMMANDCONTEXT pCtx);
209	RTDECL(bool) VBoxHGSMIIsSupported(void);
210	RTDECL(void *) VBoxHGSMIBufferAlloc(PHGSMIGUESTCOMMANDCONTEXT pCtx,
211	HGSMISIZE cbData,
212	uint8_t u8Ch,
213	uint16_t u16Op);
214	RTDECL(void) VBoxHGSMIBufferFree(PHGSMIGUESTCOMMANDCONTEXT pCtx,
215	void *pvBuffer);
216	RTDECL(int) VBoxHGSMIBufferSubmit(PHGSMIGUESTCOMMANDCONTEXT pCtx,
217	void *pvBuffer);
218	RTDECL(void) VBoxHGSMIGetBaseMappingInfo(uint32_t cbVRAM,
219	uint32_t *poffVRAMBaseMapping,
220	uint32_t *pcbMapping,
221	uint32_t *poffGuestHeapMemory,
222	uint32_t *pcbGuestHeapMemory,
223	uint32_t *poffHostFlags);
224	/** @todo we should provide a cleanup function too as part of the API */
225	RTDECL(int) VBoxHGSMISetupGuestContext(PHGSMIGUESTCOMMANDCONTEXT pCtx,
226	void *pvGuestHeapMemory,
227	uint32_t cbGuestHeapMemory,
228	uint32_t offVRAMGuestHeapMemory);
229	RTDECL(void) VBoxHGSMIGetHostAreaMapping(PHGSMIGUESTCOMMANDCONTEXT pCtx,
230	uint32_t cbVRAM,
231	uint32_t offVRAMBaseMapping,
232	uint32_t *poffVRAMHostArea,
233	uint32_t *pcbHostArea);
234	RTDECL(void) VBoxHGSMISetupHostContext(PHGSMIHOSTCOMMANDCONTEXT pCtx,
235	void *pvBaseMapping,
236	uint32_t offHostFlags,
237	void *pvHostAreaMapping,
238	uint32_t offVRAMHostArea,
239	uint32_t cbHostArea);
240	RTDECL(int) VBoxHGSMISendHostCtxInfo(PHGSMIGUESTCOMMANDCONTEXT pCtx,
241	HGSMIOFFSET offVRAMFlagsLocation,
242	uint32_t fCaps,
243	uint32_t offVRAMHostArea,
244	uint32_t cbHostArea);
245	RTDECL(int) VBoxQueryConfHGSMI(PHGSMIGUESTCOMMANDCONTEXT pCtx,
246	uint32_t u32Index, uint32_t *pulValue);
247	RTDECL(bool) VBoxHGSMIUpdatePointerShape(PHGSMIGUESTCOMMANDCONTEXT pCtx,
248	uint32_t fFlags,
249	uint32_t cHotX,
250	uint32_t cHotY,
251	uint32_t cWidth,
252	uint32_t cHeight,
253	uint8_t *pPixels,
254	uint32_t cbLength);
255
256	/** @} */
257
258	/** @name VBVA APIs
259	* @{ */
260	RTDECL(bool) VBoxVBVAEnable(PVBVABUFFERCONTEXT pCtx,
261	PHGSMIGUESTCOMMANDCONTEXT pHGSMICtx,
262	struct VBVABUFFER *pVBVA, int32_t cScreen);
263	RTDECL(void) VBoxVBVADisable(PVBVABUFFERCONTEXT pCtx,
264	PHGSMIGUESTCOMMANDCONTEXT pHGSMICtx,
265	int32_t cScreen);
266	RTDECL(bool) VBoxVBVABufferBeginUpdate(PVBVABUFFERCONTEXT pCtx,
267	PHGSMIGUESTCOMMANDCONTEXT pHGSMICtx);
268	RTDECL(void) VBoxVBVABufferEndUpdate(PVBVABUFFERCONTEXT pCtx);
269	RTDECL(bool) VBoxVBVAWrite(PVBVABUFFERCONTEXT pCtx,
270	PHGSMIGUESTCOMMANDCONTEXT pHGSMICtx,
271	const void *pv, uint32_t cb);
272	RTDECL(bool) VBoxVBVAOrderSupported(PVBVABUFFERCONTEXT pCtx, unsigned code);
273	RTDECL(void) VBoxVBVASetupBufferContext(PVBVABUFFERCONTEXT pCtx,
274	uint32_t offVRAMBuffer,
275	uint32_t cbBuffer);
276
277	/** @} */
278
279	/** @name Modesetting APIs
280	* @{ */
281
282	RTDECL(uint32_t) VBoxHGSMIGetMonitorCount(PHGSMIGUESTCOMMANDCONTEXT pCtx);
283	RTDECL(uint32_t) VBoxVideoGetVRAMSize(void);
284	RTDECL(bool) VBoxVideoAnyWidthAllowed(void);
285
286	struct VBVAINFOVIEW;
287	/**
288	* Callback funtion called from @a VBoxHGSMISendViewInfo to initialise
289	* the @a VBVAINFOVIEW structure for each screen.
290	*
291	* @returns iprt status code
292	* @param pvData context data for the callback, passed to @a
293	* VBoxHGSMISendViewInfo along with the callback
294	* @param pInfo array of @a VBVAINFOVIEW structures to be filled in
295	* @todo explicitly pass the array size
296	*/
297	typedef DECLCALLBACK(int) FNHGSMIFILLVIEWINFO(void *pvData,
298	struct VBVAINFOVIEW *pInfo,
299	uint32_t cViews);
300	/** Pointer to a FNHGSMIFILLVIEWINFO callback */
301	typedef FNHGSMIFILLVIEWINFO *PFNHGSMIFILLVIEWINFO;
302
303	RTDECL(int) VBoxHGSMISendViewInfo(PHGSMIGUESTCOMMANDCONTEXT pCtx,
304	uint32_t u32Count,
305	PFNHGSMIFILLVIEWINFO pfnFill,
306	void *pvData);
307	RTDECL(void) VBoxVideoSetModeRegisters(uint16_t cWidth, uint16_t cHeight,
308	uint16_t cVirtWidth, uint16_t cBPP,
309	uint16_t fFlags,
310	uint16_t cx, uint16_t cy);
311	RTDECL(bool) VBoxVideoGetModeRegisters(uint16_t *pcWidth,
312	uint16_t *pcHeight,
313	uint16_t *pcVirtWidth,
314	uint16_t *pcBPP,
315	uint16_t *pfFlags);
316	RTDECL(void) VBoxVideoDisableVBE(void);
317	RTDECL(void) VBoxHGSMIProcessDisplayInfo(PHGSMIGUESTCOMMANDCONTEXT pCtx,
318	uint32_t cDisplay,
319	int32_t cOriginX,
320	int32_t cOriginY,
321	uint32_t offStart,
322	uint32_t cbPitch,
323	uint32_t cWidth,
324	uint32_t cHeight,
325	uint16_t cBPP,
326	uint16_t fFlags);
327
328	/** @} */
329
330	RT_C_DECLS_END
331
332	#endif /* __HGSMI_GUEST_h__*/

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/include/VBox/VBoxVideoGuest.h@ 46093

Download in other formats: