VirtualBox

source: vbox/trunk/include/VBox/VBoxGuest.h@ 44992

Last change on this file since 44992 was 44992, checked in by vboxsync, 12 years ago

VBOX_WITH_DPC_LATENCY_CHECKER: Some adjustments. Please, don't use #pragma pack() unless you really need and mean it! Misaligning data just makes things slow...

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 19.6 KB
Line 
1/** @file
2 * VBoxGuest - VirtualBox Guest Additions Driver Interface. (ADD,DEV)
3 *
4 * @remarks This is in the process of being split up and usage cleaned up.
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#ifndef ___VBox_VBoxGuest_h
29#define ___VBox_VBoxGuest_h
30
31#include <VBox/cdefs.h>
32#include <VBox/types.h>
33#include <iprt/assert.h>
34#include <VBox/VMMDev2.h>
35#include <VBox/VBoxGuest2.h>
36
37
38/** @defgroup grp_vboxguest VirtualBox Guest Additions Driver Interface
39 * @{
40 */
41
42/** @todo it would be nice if we could have two define without paths. */
43
44/** @def VBOXGUEST_DEVICE_NAME
45 * The support device name. */
46/** @def VBOXGUEST_USER_DEVICE_NAME
47 * The support device name of the user accessible device node. */
48
49#if defined(RT_OS_OS2)
50# define VBOXGUEST_DEVICE_NAME "\\Dev\\VBoxGst$"
51
52#elif defined(RT_OS_WINDOWS)
53# define VBOXGUEST_DEVICE_NAME "\\\\.\\VBoxGuest"
54
55/** The support service name. */
56# define VBOXGUEST_SERVICE_NAME "VBoxGuest"
57/** Global name for Win2k+ */
58# define VBOXGUEST_DEVICE_NAME_GLOBAL "\\\\.\\Global\\VBoxGuest"
59/** Win32 driver name */
60# define VBOXGUEST_DEVICE_NAME_NT L"\\Device\\VBoxGuest"
61/** Device name. */
62# define VBOXGUEST_DEVICE_NAME_DOS L"\\DosDevices\\VBoxGuest"
63
64#elif defined(RT_OS_HAIKU)
65# define VBOXGUEST_DEVICE_NAME "/dev/misc/vboxguest"
66
67#else /* (PORTME) */
68# define VBOXGUEST_DEVICE_NAME "/dev/vboxguest"
69# if defined(RT_OS_LINUX)
70# define VBOXGUEST_USER_DEVICE_NAME "/dev/vboxuser"
71# endif
72#endif
73
74#ifndef VBOXGUEST_USER_DEVICE_NAME
75# define VBOXGUEST_USER_DEVICE_NAME VBOXGUEST_DEVICE_NAME
76#endif
77
78/** Fictive start address of the hypervisor physical memory for MmMapIoSpace. */
79#define VBOXGUEST_HYPERVISOR_PHYSICAL_START UINT32_C(0xf8000000)
80
81
82#if !defined(IN_RC) && !defined(IN_RING0_AGNOSTIC) && !defined(IPRT_NO_CRT)
83/** @name VBoxGuest IOCTL codes and structures.
84 *
85 * The range 0..15 is for basic driver communication.
86 * The range 16..31 is for HGCM communication.
87 * The range 32..47 is reserved for future use.
88 * The range 48..63 is for OS specific communication.
89 * The 7th bit is reserved for future hacks.
90 * The 8th bit is reserved for distinguishing between 32-bit and 64-bit
91 * processes in future 64-bit guest additions.
92 *
93 * @remarks When creating new IOCtl interfaces keep in mind that not all OSes supports
94 * reporting back the output size. (This got messed up a little bit in VBoxDrv.)
95 *
96 * The request size is also a little bit tricky as it's passed as part of the
97 * request code on unix. The size field is 14 bits on Linux, 12 bits on *BSD,
98 * 13 bits Darwin, and 8-bits on Solaris. All the BSDs and Darwin kernels
99 * will make use of the size field, while Linux and Solaris will not. We're of
100 * course using the size to validate and/or map/lock the request, so it has
101 * to be valid.
102 *
103 * For Solaris we will have to do something special though, 255 isn't
104 * sufficient for all we need. A 4KB restriction (BSD) is probably not
105 * too problematic (yet) as a general one.
106 *
107 * More info can be found in SUPDRVIOC.h and related sources.
108 *
109 * @remarks If adding interfaces that only has input or only has output, some new macros
110 * needs to be created so the most efficient IOCtl data buffering method can be
111 * used.
112 * @{
113 */
114#if defined(RT_ARCH_AMD64) || defined(RT_ARCH_SPARC64)
115# define VBOXGUEST_IOCTL_FLAG 128
116#elif defined(RT_ARCH_X86) || defined(RT_ARCH_SPARC)
117# define VBOXGUEST_IOCTL_FLAG 0
118#else
119# error "dunno which arch this is!"
120#endif
121/** @} */
122
123/** Ring-3 request wrapper for big requests.
124 *
125 * This is necessary because the ioctl number scheme on many Unixy OSes (esp. Solaris)
126 * only allows a relatively small size to be encoded into the request. So, for big
127 * request this generic form is used instead. */
128typedef struct VBGLBIGREQ
129{
130 /** Magic value (VBGLBIGREQ_MAGIC). */
131 uint32_t u32Magic;
132 /** The size of the data buffer. */
133 uint32_t cbData;
134 /** The user address of the data buffer. */
135 RTR3PTR pvDataR3;
136#if HC_ARCH_BITS == 32
137 uint32_t u32Padding;
138#endif
139/** @todo r=bird: We need a 'rc' field for passing VBox status codes. Reused
140 * some input field as rc on output. */
141} VBGLBIGREQ;
142/** Pointer to a request wrapper for solaris guests. */
143typedef VBGLBIGREQ *PVBGLBIGREQ;
144/** Pointer to a const request wrapper for solaris guests. */
145typedef const VBGLBIGREQ *PCVBGLBIGREQ;
146
147/** The VBGLBIGREQ::u32Magic value (Ryuu Murakami). */
148#define VBGLBIGREQ_MAGIC 0x19520219
149
150
151#if defined(RT_OS_WINDOWS)
152/** @todo Remove IOCTL_CODE later! Integrate it in VBOXGUEST_IOCTL_CODE below. */
153/** @todo r=bird: IOCTL_CODE is supposedly defined in some header included by Windows.h or ntddk.h, which is why it wasn't in the #if 0 earlier. See HostDrivers/Support/SUPDrvIOC.h... */
154# define IOCTL_CODE(DeviceType, Function, Method, Access, DataSize_ignored) \
155 ( ((DeviceType) << 16) | ((Access) << 14) | ((Function) << 2) | (Method))
156# define VBOXGUEST_IOCTL_CODE_(Function, Size) IOCTL_CODE(FILE_DEVICE_UNKNOWN, 2048 + (Function), METHOD_BUFFERED, FILE_WRITE_ACCESS, 0)
157# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) (Code)
158
159#elif defined(RT_OS_OS2)
160 /* No automatic buffering, size not encoded. */
161# define VBOXGUEST_IOCTL_CATEGORY 0xc2
162# define VBOXGUEST_IOCTL_CODE_(Function, Size) ((unsigned char)(Function))
163# define VBOXGUEST_IOCTL_CATEGORY_FAST 0xc3 /**< Also defined in VBoxGuestA-os2.asm. */
164# define VBOXGUEST_IOCTL_CODE_FAST_(Function) ((unsigned char)(Function))
165# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) (Code)
166
167#elif defined(RT_OS_SOLARIS)
168 /* No automatic buffering, size limited to 255 bytes => use VBGLBIGREQ for everything. */
169# include <sys/ioccom.h>
170# define VBOXGUEST_IOCTL_CODE_(Function, Size) _IOWRN('V', (Function), sizeof(VBGLBIGREQ))
171# define VBOXGUEST_IOCTL_CODE_FAST_(Function) _IO( 'V', (Function))
172# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) (Code)
173
174#elif defined(RT_OS_LINUX)
175 /* No automatic buffering, size limited to 16KB. */
176# include <linux/ioctl.h>
177# define VBOXGUEST_IOCTL_CODE_(Function, Size) _IOC(_IOC_READ|_IOC_WRITE, 'V', (Function), (Size))
178# define VBOXGUEST_IOCTL_CODE_FAST_(Function) _IO( 'V', (Function))
179# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) VBOXGUEST_IOCTL_CODE_(_IOC_NR((Code)), 0)
180
181#elif defined(RT_OS_HAIKU)
182 /* No automatic buffering, size not encoded. */
183 /** @todo do something better */
184# define VBOXGUEST_IOCTL_CODE_(Function, Size) (0x56420000 | (Function))
185# define VBOXGUEST_IOCTL_CODE_FAST_(Function) (0x56420000 | (Function))
186# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) (Code)
187
188#elif defined(RT_OS_FREEBSD) /** @todo r=bird: Please do it like SUPDRVIOC to keep it as similar as possible. */
189# include <sys/ioccom.h>
190
191# define VBOXGUEST_IOCTL_CODE_(Function, Size) _IOWR('V', (Function), VBGLBIGREQ)
192# define VBOXGUEST_IOCTL_CODE_FAST_(Function) _IO( 'V', (Function))
193# define VBOXGUEST_IOCTL_STRIP_SIZE(Code) IOCBASECMD(Code)
194
195#else /* BSD Like */
196 /* Automatic buffering, size limited to 4KB on *BSD and 8KB on Darwin - commands the limit, 4KB. */
197# include <sys/ioccom.h>
198# define VBOXGUEST_IOCTL_CODE_(Function, Size) _IOC(IOC_INOUT, 'V', (Function) | VBOXGUEST_IOCTL_FLAG, (Size))
199# define VBOXGUEST_IOCTL_CODE_FAST_(Function) _IO('V', (Function) | VBOXGUEST_IOCTL_FLAG)
200# define VBOXGUEST_IOCTL_STRIP_SIZE(uIOCtl) ( (uIOCtl) & ~_IOC(0,0,0,IOCPARM_MASK) )
201#endif
202
203#define VBOXGUEST_IOCTL_CODE(Function, Size) VBOXGUEST_IOCTL_CODE_((Function) | VBOXGUEST_IOCTL_FLAG, Size)
204#define VBOXGUEST_IOCTL_CODE_FAST(Function) VBOXGUEST_IOCTL_CODE_FAST_((Function) | VBOXGUEST_IOCTL_FLAG)
205
206/* Define 32 bit codes to support 32 bit applications requests in the 64 bit guest driver. */
207#ifdef RT_ARCH_AMD64
208# define VBOXGUEST_IOCTL_CODE_32(Function, Size) VBOXGUEST_IOCTL_CODE_(Function, Size)
209# define VBOXGUEST_IOCTL_CODE_FAST_32(Function) VBOXGUEST_IOCTL_CODE_FAST_(Function)
210#endif /* RT_ARCH_AMD64 */
211
212
213
214/** IOCTL to VBoxGuest to query the VMMDev IO port region start.
215 * @remarks Ring-0 only. */
216#define VBOXGUEST_IOCTL_GETVMMDEVPORT VBOXGUEST_IOCTL_CODE(1, sizeof(VBoxGuestPortInfo))
217
218#pragma pack(4)
219typedef struct VBoxGuestPortInfo
220{
221 uint32_t portAddress;
222 struct VMMDevMemory *pVMMDevMemory;
223} VBoxGuestPortInfo;
224
225
226/** IOCTL to VBoxGuest to wait for a VMMDev host notification */
227#define VBOXGUEST_IOCTL_WAITEVENT VBOXGUEST_IOCTL_CODE_(2, sizeof(VBoxGuestWaitEventInfo))
228
229/** @name Result codes for VBoxGuestWaitEventInfo::u32Result
230 * @{
231 */
232/** Successful completion, an event occurred. */
233#define VBOXGUEST_WAITEVENT_OK (0)
234/** Successful completion, timed out. */
235#define VBOXGUEST_WAITEVENT_TIMEOUT (1)
236/** Wait was interrupted. */
237#define VBOXGUEST_WAITEVENT_INTERRUPTED (2)
238/** An error occurred while processing the request. */
239#define VBOXGUEST_WAITEVENT_ERROR (3)
240/** @} */
241
242/** Input and output buffers layout of the IOCTL_VBOXGUEST_WAITEVENT */
243typedef struct VBoxGuestWaitEventInfo
244{
245 /** timeout in milliseconds */
246 uint32_t u32TimeoutIn;
247 /** events to wait for */
248 uint32_t u32EventMaskIn;
249 /** result code */
250 uint32_t u32Result;
251 /** events occurred */
252 uint32_t u32EventFlagsOut;
253} VBoxGuestWaitEventInfo;
254AssertCompileSize(VBoxGuestWaitEventInfo, 16);
255
256
257/** IOCTL to VBoxGuest to perform a VMM request
258 * @remark The data buffer for this IOCtl has an variable size, keep this in mind
259 * on systems where this matters. */
260#define VBOXGUEST_IOCTL_VMMREQUEST(Size) VBOXGUEST_IOCTL_CODE_(3, (Size))
261
262
263/** IOCTL to VBoxGuest to control event filter mask. */
264#define VBOXGUEST_IOCTL_CTL_FILTER_MASK VBOXGUEST_IOCTL_CODE_(4, sizeof(VBoxGuestFilterMaskInfo))
265
266/** Input and output buffer layout of the IOCTL_VBOXGUEST_CTL_FILTER_MASK. */
267typedef struct VBoxGuestFilterMaskInfo
268{
269 uint32_t u32OrMask;
270 uint32_t u32NotMask;
271} VBoxGuestFilterMaskInfo;
272AssertCompileSize(VBoxGuestFilterMaskInfo, 8);
273#pragma pack()
274
275/** IOCTL to VBoxGuest to interrupt (cancel) any pending WAITEVENTs and return.
276 * Handled inside the guest additions and not seen by the host at all.
277 * @see VBOXGUEST_IOCTL_WAITEVENT */
278#define VBOXGUEST_IOCTL_CANCEL_ALL_WAITEVENTS VBOXGUEST_IOCTL_CODE_(5, 0)
279
280/** IOCTL to VBoxGuest to perform backdoor logging.
281 * The argument is a string buffer of the specified size. */
282#define VBOXGUEST_IOCTL_LOG(Size) VBOXGUEST_IOCTL_CODE_(6, (Size))
283
284/** IOCTL to VBoxGuest to check memory ballooning.
285 * The guest kernel module / device driver will ask the host for the current size of
286 * the balloon and adjust the size. Or it will set fHandledInR0 = false and R3 is
287 * responsible for allocating memory and calling R0 (VBOXGUEST_IOCTL_CHANGE_BALLOON). */
288#define VBOXGUEST_IOCTL_CHECK_BALLOON VBOXGUEST_IOCTL_CODE_(7, sizeof(VBoxGuestCheckBalloonInfo))
289
290/** Output buffer layout of the VBOXGUEST_IOCTL_CHECK_BALLOON. */
291typedef struct VBoxGuestCheckBalloonInfo
292{
293 /** The size of the balloon in chunks of 1MB. */
294 uint32_t cBalloonChunks;
295 /** false = handled in R0, no further action required.
296 * true = allocate balloon memory in R3. */
297 uint32_t fHandleInR3;
298} VBoxGuestCheckBalloonInfo;
299AssertCompileSize(VBoxGuestCheckBalloonInfo, 8);
300
301
302/** IOCTL to VBoxGuest to supply or revoke one chunk for ballooning.
303 * The guest kernel module / device driver will lock down supplied memory or
304 * unlock reclaimed memory and then forward the physical addresses of the
305 * changed balloon chunk to the host. */
306#define VBOXGUEST_IOCTL_CHANGE_BALLOON VBOXGUEST_IOCTL_CODE_(8, sizeof(VBoxGuestChangeBalloonInfo))
307
308/** Input buffer layout of the VBOXGUEST_IOCTL_CHANGE_BALLOON request.
309 * Information about a memory chunk used to inflate or deflate the balloon. */
310typedef struct VBoxGuestChangeBalloonInfo
311{
312 /** Address of the chunk. */
313 uint64_t u64ChunkAddr;
314 /** true = inflate, false = deflate. */
315 uint32_t fInflate;
316 /** Alignment padding. */
317 uint32_t u32Align;
318} VBoxGuestChangeBalloonInfo;
319AssertCompileSize(VBoxGuestChangeBalloonInfo, 16);
320
321/** IOCTL to VBoxGuest to write guest core. */
322#define VBOXGUEST_IOCTL_WRITE_CORE_DUMP VBOXGUEST_IOCTL_CODE(9, sizeof(VBoxGuestWriteCoreDump))
323
324/** Input and output buffer layout of the VBOXGUEST_IOCTL_WRITE_CORE
325 * request. */
326typedef struct VBoxGuestWriteCoreDump
327{
328 /** Flags (reserved, MBZ). */
329 uint32_t fFlags;
330} VBoxGuestWriteCoreDump;
331AssertCompileSize(VBoxGuestWriteCoreDump, 4);
332
333/** IOCTL to VBoxGuest to update the mouse status features. */
334# define VBOXGUEST_IOCTL_SET_MOUSE_STATUS VBOXGUEST_IOCTL_CODE_(10, sizeof(uint32_t))
335
336#ifdef VBOX_WITH_HGCM
337/** IOCTL to VBoxGuest to connect to a HGCM service. */
338# define VBOXGUEST_IOCTL_HGCM_CONNECT VBOXGUEST_IOCTL_CODE(16, sizeof(VBoxGuestHGCMConnectInfo))
339
340/** IOCTL to VBoxGuest to disconnect from a HGCM service. */
341# define VBOXGUEST_IOCTL_HGCM_DISCONNECT VBOXGUEST_IOCTL_CODE(17, sizeof(VBoxGuestHGCMDisconnectInfo))
342
343/** IOCTL to VBoxGuest to make a call to a HGCM service.
344 * @see VBoxGuestHGCMCallInfo */
345# define VBOXGUEST_IOCTL_HGCM_CALL(Size) VBOXGUEST_IOCTL_CODE(18, (Size))
346
347/** IOCTL to VBoxGuest to make a timed call to a HGCM service. */
348# define VBOXGUEST_IOCTL_HGCM_CALL_TIMED(Size) VBOXGUEST_IOCTL_CODE(20, (Size))
349
350/** IOCTL to VBoxGuest passed from the Kernel Mode driver, but containing a user mode data in VBoxGuestHGCMCallInfo
351 * the driver received from the UM. Called in the context of the process passing the data.
352 * @see VBoxGuestHGCMCallInfo */
353# define VBOXGUEST_IOCTL_HGCM_CALL_USERDATA(Size) VBOXGUEST_IOCTL_CODE(21, (Size))
354
355# ifdef RT_ARCH_AMD64
356/** @name IOCTL numbers that 32-bit clients, like the Windows OpenGL guest
357 * driver, will use when taking to a 64-bit driver.
358 * @remarks These are only used by the driver implementation! */
359# define VBOXGUEST_IOCTL_HGCM_CONNECT_32 VBOXGUEST_IOCTL_CODE_32(16, sizeof(VBoxGuestHGCMConnectInfo))
360# define VBOXGUEST_IOCTL_HGCM_DISCONNECT_32 VBOXGUEST_IOCTL_CODE_32(17, sizeof(VBoxGuestHGCMDisconnectInfo))
361# define VBOXGUEST_IOCTL_HGCM_CALL_32(Size) VBOXGUEST_IOCTL_CODE_32(18, (Size))
362# define VBOXGUEST_IOCTL_HGCM_CALL_TIMED_32(Size) VBOXGUEST_IOCTL_CODE_32(20, (Size))
363/** @} */
364# endif /* RT_ARCH_AMD64 */
365
366/** Get the pointer to the first HGCM parameter. */
367# define VBOXGUEST_HGCM_CALL_PARMS(a) ( (HGCMFunctionParameter *)((uint8_t *)(a) + sizeof(VBoxGuestHGCMCallInfo)) )
368/** Get the pointer to the first HGCM parameter in a 32-bit request. */
369# define VBOXGUEST_HGCM_CALL_PARMS32(a) ( (HGCMFunctionParameter32 *)((uint8_t *)(a) + sizeof(VBoxGuestHGCMCallInfo)) )
370
371#endif /* VBOX_WITH_HGCM */
372
373#ifdef VBOX_WITH_DPC_LATENCY_CHECKER
374/** IOCTL to VBoxGuest to perform DPC latency tests, printing the result in
375 * the release log on the host. Takes no data, returns no data. */
376# define VBOXGUEST_IOCTL_DPC_LATENCY_CHECKER VBOXGUEST_IOCTL_CODE_(30, 0)
377#endif
378
379/** IOCTL to for setting the mouse driver callback. (kernel only)
380 * @todo r=bird: Why is this using VBOXGUEST_IOCTL_CODE_ and not
381 * VBOXGUEST_IOCTL_CODE? Doesn't make any sense to me as the data is bit
382 * specific...
383 */
384#define VBOXGUEST_IOCTL_SET_MOUSE_NOTIFY_CALLBACK VBOXGUEST_IOCTL_CODE_(31, sizeof(VBoxGuestMouseSetNotifyCallback))
385
386typedef DECLCALLBACK(void) FNVBOXGUESTMOUSENOTIFY(void *pfnUser);
387typedef FNVBOXGUESTMOUSENOTIFY *PFNVBOXGUESTMOUSENOTIFY;
388
389/** Input buffer for VBOXGUEST_IOCTL_INTERNAL_SET_MOUSE_NOTIFY_CALLBACK. */
390typedef struct VBoxGuestMouseSetNotifyCallback
391{
392 /**
393 * Mouse notification callback.
394 *
395 * @param pvUser The callback argument.
396 */
397 PFNVBOXGUESTMOUSENOTIFY pfnNotify;
398 /** The callback argument*/
399 void *pvUser;
400} VBoxGuestMouseSetNotifyCallback;
401
402
403#ifdef RT_OS_OS2
404
405/**
406 * The data buffer layout for the IDC entry point (AttachDD).
407 *
408 * @remark This is defined in multiple 16-bit headers / sources.
409 * Some places it's called VBGOS2IDC to short things a bit.
410 */
411typedef struct VBOXGUESTOS2IDCCONNECT
412{
413 /** VMMDEV_VERSION. */
414 uint32_t u32Version;
415 /** Opaque session handle. */
416 uint32_t u32Session;
417
418 /**
419 * The 32-bit service entry point.
420 *
421 * @returns VBox status code.
422 * @param u32Session The above session handle.
423 * @param iFunction The requested function.
424 * @param pvData The input/output data buffer. The caller ensures that this
425 * cannot be swapped out, or that it's acceptable to take a
426 * page in fault in the current context. If the request doesn't
427 * take input or produces output, apssing NULL is okay.
428 * @param cbData The size of the data buffer.
429 * @param pcbDataReturned Where to store the amount of data that's returned.
430 * This can be NULL if pvData is NULL.
431 */
432 DECLCALLBACKMEMBER(int, pfnServiceEP)(uint32_t u32Session, unsigned iFunction, void *pvData, size_t cbData, size_t *pcbDataReturned);
433
434 /** The 16-bit service entry point for C code (cdecl).
435 *
436 * It's the same as the 32-bit entry point, but the types has
437 * changed to 16-bit equivalents.
438 *
439 * @code
440 * int far cdecl
441 * VBoxGuestOs2IDCService16(uint32_t u32Session, uint16_t iFunction,
442 * void far *fpvData, uint16_t cbData, uint16_t far *pcbDataReturned);
443 * @endcode
444 */
445 RTFAR16 fpfnServiceEP;
446
447 /** The 16-bit service entry point for Assembly code (register).
448 *
449 * This is just a wrapper around fpfnServiceEP to simplify calls
450 * from 16-bit assembly code.
451 *
452 * @returns (e)ax: VBox status code; cx: The amount of data returned.
453 *
454 * @param u32Session eax - The above session handle.
455 * @param iFunction dl - The requested function.
456 * @param pvData es:bx - The input/output data buffer.
457 * @param cbData cx - The size of the data buffer.
458 */
459 RTFAR16 fpfnServiceAsmEP;
460} VBOXGUESTOS2IDCCONNECT;
461/** Pointer to VBOXGUESTOS2IDCCONNECT buffer. */
462typedef VBOXGUESTOS2IDCCONNECT *PVBOXGUESTOS2IDCCONNECT;
463
464/** OS/2 specific: IDC client disconnect request.
465 *
466 * This takes no input and it doesn't return anything. Obviously this
467 * is only recognized if it arrives thru the IDC service EP.
468 */
469# define VBOXGUEST_IOCTL_OS2_IDC_DISCONNECT VBOXGUEST_IOCTL_CODE(48, sizeof(uint32_t))
470
471#endif /* RT_OS_OS2 */
472
473/** @} */
474#endif /* !defined(IN_RC) && !defined(IN_RING0_AGNOSTIC) && !defined(IPRT_NO_CRT) */
475
476#endif
477
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette