vd-plugin.h@ 48743

Last change on this file since 48743 was 48743, checked in by vboxsync, 11 years ago
Storage/VD: Add support for different sector sizes (only opening and reading and writing images, not creating them with a sector size other than 512 bytes)
Property svn:eol-style set to `native`
File size: 25.4 KB

Line
1	/** @file
2	* Internal hard disk format support API for VBoxHDD.
3	*/
4
5	/*
6	* Copyright (C) 2006-2013 Oracle Corporation
7	*
8	* This file is part of VirtualBox Open Source Edition (OSE), as
9	* available from http://www.virtualbox.org. This file is free software;
10	* you can redistribute it and/or modify it under the terms of the GNU
11	* General Public License (GPL) as published by the Free Software
12	* Foundation, in version 2 as it comes in the "COPYING" file of the
13	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15	*
16	* The contents of this file may alternatively be used under the terms
17	* of the Common Development and Distribution License Version 1.0
18	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19	* VirtualBox OSE distribution, in which case the provisions of the
20	* CDDL are applicable instead of those of the GPL.
21	*
22	* You may elect to license modified versions of this file under the
23	* terms and conditions of either the GPL or the CDDL or both.
24	*/
25
26	#ifndef __VBoxHDD_Plugin_h__
27	#define __VBoxHDD_Plugin_h__
28
29	#include <VBox/vd.h>
30	#include <VBox/vd-ifs-internal.h>
31
32
33	/** @name VBox HDD backend write flags
34	* @{
35	*/
36	/** Do not allocate a new block on this write. This is just an advisory
37	* flag. The backend may still decide in some circumstances that it wants
38	* to ignore this flag (which may cause extra dynamic image expansion). */
39	#define VD_WRITE_NO_ALLOC RT_BIT(1)
40	/** @}*/
41
42	/** @name VBox HDD backend discard flags
43	* @{
44	*/
45	/** Don't discard block but mark the given range as unused
46	* (usually by writing 0's to it).
47	* This doesn't require the range to be aligned on a block boundary but
48	* the image size might not be decreased. */
49	#define VD_DISCARD_MARK_UNUSED RT_BIT(0)
50	/** @}*/
51
52
53	/**
54	* Image format backend interface used by VBox HDD Container implementation.
55	*/
56	typedef struct VBOXHDDBACKEND
57	{
58	/**
59	* The name of the backend (constant string).
60	*/
61	const char *pszBackendName;
62
63	/**
64	* The size of the structure.
65	*/
66	uint32_t cbSize;
67
68	/**
69	* The capabilities of the backend.
70	*/
71	uint64_t uBackendCaps;
72
73	/**
74	* Pointer to a NULL-terminated array, containing the supported
75	* file extensions. Note that some backends do not work on files, so this
76	* pointer may just contain NULL.
77	*/
78	PCVDFILEEXTENSION paFileExtensions;
79
80	/**
81	* Pointer to an array of structs describing each supported config key.
82	* Terminated by a NULL config key. Note that some backends do not support
83	* the configuration interface, so this pointer may just contain NULL.
84	* Mandatory if the backend sets VD_CAP_CONFIG.
85	*/
86	PCVDCONFIGINFO paConfigInfo;
87
88	/**
89	* Handle of loaded plugin library, NIL_RTLDRMOD for static backends.
90	*/
91	RTLDRMOD hPlugin;
92
93	/**
94	* Check if a file is valid for the backend.
95	*
96	* @returns VBox status code.
97	* @param pszFilename Name of the image file.
98	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
99	* @param pVDIfsImage Pointer to the per-image VD interface list.
100	* @param penmType Returns the supported device type on success.
101	*/
102	DECLR3CALLBACKMEMBER(int, pfnCheckIfValid, (const char *pszFilename, PVDINTERFACE pVDIfsDisk,
103	PVDINTERFACE pVDIfsImage, VDTYPE *penmType));
104
105	/**
106	* Open a disk image.
107	*
108	* @returns VBox status code.
109	* @param pszFilename Name of the image file to open. Guaranteed to be available and
110	* unchanged during the lifetime of this image.
111	* @param uOpenFlags Image file open mode, see VD_OPEN_FLAGS_* constants.
112	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
113	* @param pVDIfsImage Pointer to the per-image VD interface list.
114	* @param enmType Requested type of the image.
115	* @param ppBackendData Opaque state data for this image.
116	*/
117	DECLR3CALLBACKMEMBER(int, pfnOpen, (const char *pszFilename, unsigned uOpenFlags,
118	PVDINTERFACE pVDIfsDisk, PVDINTERFACE pVDIfsImage,
119	VDTYPE enmType, void **ppBackendData));
120
121	/**
122	* Create a disk image.
123	*
124	* @returns VBox status code.
125	* @param pszFilename Name of the image file to create. Guaranteed to be available and
126	* unchanged during the lifetime of this image.
127	* @param cbSize Image size in bytes.
128	* @param uImageFlags Flags specifying special image features.
129	* @param pszComment Pointer to image comment. NULL is ok.
130	* @param pPCHSGeometry Physical drive geometry CHS <= (16383,16,255).
131	* @param pLCHSGeometry Logical drive geometry CHS <= (1024,255,63).
132	* @param pUuid New UUID of the image. Not NULL.
133	* @param uOpenFlags Image file open mode, see VD_OPEN_FLAGS_* constants.
134	* @param uPercentStart Starting value for progress percentage.
135	* @param uPercentSpan Span for varying progress percentage.
136	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
137	* @param pVDIfsImage Pointer to the per-image VD interface list.
138	* @param pVDIfsOperation Pointer to the per-operation VD interface list.
139	* @param ppBackendData Opaque state data for this image.
140	*/
141	DECLR3CALLBACKMEMBER(int, pfnCreate, (const char *pszFilename, uint64_t cbSize,
142	unsigned uImageFlags, const char *pszComment,
143	PCVDGEOMETRY pPCHSGeometry,
144	PCVDGEOMETRY pLCHSGeometry,
145	PCRTUUID pUuid, unsigned uOpenFlags,
146	unsigned uPercentStart, unsigned uPercentSpan,
147	PVDINTERFACE pVDIfsDisk,
148	PVDINTERFACE pVDIfsImage,
149	PVDINTERFACE pVDIfsOperation,
150	void **ppBackendData));
151
152	/**
153	* Rename a disk image. Only needs to work as long as the operating
154	* system's rename file functionality is usable. If an attempt is made to
155	* rename an image to a location on another disk/filesystem, this function
156	* may just fail with an appropriate error code (not changing the opened
157	* image data at all). Also works only on images which actually refer to
158	* regular files. May be NULL.
159	*
160	* @returns VBox status code.
161	* @param pBackendData Opaque state data for this image.
162	* @param pszFilename New name of the image file. Guaranteed to be available and
163	* unchanged during the lifetime of this image.
164	*/
165	DECLR3CALLBACKMEMBER(int, pfnRename, (void pBackendData, const char pszFilename));
166
167	/**
168	* Close a disk image.
169	*
170	* @returns VBox status code.
171	* @param pBackendData Opaque state data for this image.
172	* @param fDelete If true, delete the image from the host disk.
173	*/
174	DECLR3CALLBACKMEMBER(int, pfnClose, (void *pBackendData, bool fDelete));
175
176	/**
177	* Start a read request.
178	*
179	* @returns VBox status code.
180	* @param pBackendData Opaque state data for this image.
181	* @param uOffset The offset of the virtual disk to read from.
182	* @param cbRead How many bytes to read.
183	* @param pIoCtx I/O context associated with this request.
184	* @param pcbActuallyRead Pointer to returned number of bytes read.
185	*/
186	DECLR3CALLBACKMEMBER(int, pfnRead, (void *pBackendData, uint64_t uOffset, size_t cbRead,
187	PVDIOCTX pIoCtx, size_t *pcbActuallyRead));
188
189	/**
190	* Start a write request.
191	*
192	* @returns VBox status code.
193	* @param pBackendData Opaque state data for this image.
194	* @param uOffset The offset of the virtual disk to write to.
195	* @param cbWrite How many bytes to write.
196	* @param pIoCtx I/O context associated with this request.
197	* @param pcbWriteProcess Pointer to returned number of bytes that could
198	* be processed. In case the function returned
199	* VERR_VD_BLOCK_FREE this is the number of bytes
200	* that could be written in a full block write,
201	* when prefixed/postfixed by the appropriate
202	* amount of (previously read) padding data.
203	* @param pcbPreRead Pointer to the returned amount of data that must
204	* be prefixed to perform a full block write.
205	* @param pcbPostRead Pointer to the returned amount of data that must
206	* be postfixed to perform a full block write.
207	* @param fWrite Flags which affect write behavior. Combination
208	* of the VD_WRITE_* flags.
209	*/
210	DECLR3CALLBACKMEMBER(int, pfnWrite, (void *pBackendData, uint64_t uOffset, size_t cbWrite,
211	PVDIOCTX pIoCtx,
212	size_t pcbWriteProcess, size_t pcbPreRead,
213	size_t *pcbPostRead, unsigned fWrite));
214
215	/**
216	* Flush data to disk.
217	*
218	* @returns VBox status code.
219	* @param pBackendData Opaque state data for this image.
220	* @param pIoCtx I/O context associated with this request.
221	*/
222	DECLR3CALLBACKMEMBER(int, pfnFlush, (void *pBackendData, PVDIOCTX pIoCtx));
223
224	/**
225	* Discards the given amount of bytes decreasing the size of the image if possible
226	*
227	* @returns VBox status code.
228	* @retval VERR_VD_DISCARD_ALIGNMENT_NOT_MET if the range doesn't meet the required alignment
229	* for the discard.
230	* @param pBackendData Opaque state data for this image.
231	* @param pIoCtx I/O context associated with this request.
232	* @param uOffset The offset of the first byte to discard.
233	* @param cbDiscard How many bytes to discard.
234	* @param pcbPreAllocated Pointer to the returned amount of bytes that must
235	* be discarded before the range to perform a full
236	* block discard.
237	* @param pcbPostAllocated Pointer to the returned amount of bytes that must
238	* be discarded after the range to perform a full
239	* block discard.
240	* @param pcbActuallyDiscarded Pointer to the returned amount of bytes which
241	* could be actually discarded.
242	* @param ppbmAllocationBitmap Where to store the pointer to the allocation bitmap
243	* if VERR_VD_DISCARD_ALIGNMENT_NOT_MET is returned or NULL
244	* if the allocation bitmap should be returned.
245	* @param fDiscard Flags which affect discard behavior. Combination
246	* of the VD_DISCARD_* flags.
247	*/
248	DECLR3CALLBACKMEMBER(int, pfnDiscard, (void *pBackendData, PVDIOCTX pIoCtx,
249	uint64_t uOffset, size_t cbDiscard,
250	size_t *pcbPreAllocated,
251	size_t *pcbPostAllocated,
252	size_t *pcbActuallyDiscarded,
253	void **ppbmAllocationBitmap,
254	unsigned fDiscard));
255
256	/**
257	* Get the version of a disk image.
258	*
259	* @returns version of disk image.
260	* @param pBackendData Opaque state data for this image.
261	*/
262	DECLR3CALLBACKMEMBER(unsigned, pfnGetVersion, (void *pBackendData));
263
264	/**
265	* Get the sector size of a disk image.
266	*
267	* @returns size of disk image in bytes.
268	* @param pBackendData Opaque state data for this image.
269	*/
270	DECLR3CALLBACKMEMBER(uint32_t, pfnGetSectorSize, (void *pBackendData));
271
272	/**
273	* Get the capacity of a disk image.
274	*
275	* @returns size of disk image in bytes.
276	* @param pBackendData Opaque state data for this image.
277	*/
278	DECLR3CALLBACKMEMBER(uint64_t, pfnGetSize, (void *pBackendData));
279
280	/**
281	* Get the file size of a disk image.
282	*
283	* @returns size of disk image in bytes.
284	* @param pBackendData Opaque state data for this image.
285	*/
286	DECLR3CALLBACKMEMBER(uint64_t, pfnGetFileSize, (void *pBackendData));
287
288	/**
289	* Get virtual disk PCHS geometry stored in a disk image.
290	*
291	* @returns VBox status code.
292	* @returns VERR_VD_GEOMETRY_NOT_SET if no geometry present in the image.
293	* @param pBackendData Opaque state data for this image.
294	* @param pPCHSGeometry Where to store the geometry. Not NULL.
295	*/
296	DECLR3CALLBACKMEMBER(int, pfnGetPCHSGeometry, (void *pBackendData, PVDGEOMETRY pPCHSGeometry));
297
298	/**
299	* Set virtual disk PCHS geometry stored in a disk image.
300	* Only called if geometry is different than before.
301	*
302	* @returns VBox status code.
303	* @param pBackendData Opaque state data for this image.
304	* @param pPCHSGeometry Where to load the geometry from. Not NULL.
305	*/
306	DECLR3CALLBACKMEMBER(int, pfnSetPCHSGeometry, (void *pBackendData, PCVDGEOMETRY pPCHSGeometry));
307
308	/**
309	* Get virtual disk LCHS geometry stored in a disk image.
310	*
311	* @returns VBox status code.
312	* @returns VERR_VD_GEOMETRY_NOT_SET if no geometry present in the image.
313	* @param pBackendData Opaque state data for this image.
314	* @param pLCHSGeometry Where to store the geometry. Not NULL.
315	*/
316	DECLR3CALLBACKMEMBER(int, pfnGetLCHSGeometry, (void *pBackendData, PVDGEOMETRY pLCHSGeometry));
317
318	/**
319	* Set virtual disk LCHS geometry stored in a disk image.
320	* Only called if geometry is different than before.
321	*
322	* @returns VBox status code.
323	* @param pBackendData Opaque state data for this image.
324	* @param pLCHSGeometry Where to load the geometry from. Not NULL.
325	*/
326	DECLR3CALLBACKMEMBER(int, pfnSetLCHSGeometry, (void *pBackendData, PCVDGEOMETRY pLCHSGeometry));
327
328	/**
329	* Get the image flags of a disk image.
330	*
331	* @returns image flags of disk image.
332	* @param pBackendData Opaque state data for this image.
333	*/
334	DECLR3CALLBACKMEMBER(unsigned, pfnGetImageFlags, (void *pBackendData));
335
336	/**
337	* Get the open flags of a disk image.
338	*
339	* @returns open flags of disk image.
340	* @param pBackendData Opaque state data for this image.
341	*/
342	DECLR3CALLBACKMEMBER(unsigned, pfnGetOpenFlags, (void *pBackendData));
343
344	/**
345	* Set the open flags of a disk image. May cause the image to be locked
346	* in a different mode or be reopened (which can fail).
347	*
348	* @returns VBox status code.
349	* @param pBackendData Opaque state data for this image.
350	* @param uOpenFlags New open flags for this image.
351	*/
352	DECLR3CALLBACKMEMBER(int, pfnSetOpenFlags, (void *pBackendData, unsigned uOpenFlags));
353
354	/**
355	* Get comment of a disk image.
356	*
357	* @returns VBox status code.
358	* @param pBackendData Opaque state data for this image.
359	* @param pszComment Where to store the comment.
360	* @param cbComment Size of the comment buffer.
361	*/
362	DECLR3CALLBACKMEMBER(int, pfnGetComment, (void pBackendData, char pszComment, size_t cbComment));
363
364	/**
365	* Set comment of a disk image.
366	*
367	* @returns VBox status code.
368	* @param pBackendData Opaque state data for this image.
369	* @param pszComment Where to get the comment from. NULL resets comment.
370	* The comment is silently truncated if the image format
371	* limit is exceeded.
372	*/
373	DECLR3CALLBACKMEMBER(int, pfnSetComment, (void pBackendData, const char pszComment));
374
375	/**
376	* Get UUID of a disk image.
377	*
378	* @returns VBox status code.
379	* @param pBackendData Opaque state data for this image.
380	* @param pUuid Where to store the image UUID.
381	*/
382	DECLR3CALLBACKMEMBER(int, pfnGetUuid, (void *pBackendData, PRTUUID pUuid));
383
384	/**
385	* Set UUID of a disk image.
386	*
387	* @returns VBox status code.
388	* @param pBackendData Opaque state data for this image.
389	* @param pUuid Where to get the image UUID from.
390	*/
391	DECLR3CALLBACKMEMBER(int, pfnSetUuid, (void *pBackendData, PCRTUUID pUuid));
392
393	/**
394	* Get last modification UUID of a disk image.
395	*
396	* @returns VBox status code.
397	* @param pBackendData Opaque state data for this image.
398	* @param pUuid Where to store the image modification UUID.
399	*/
400	DECLR3CALLBACKMEMBER(int, pfnGetModificationUuid, (void *pBackendData, PRTUUID pUuid));
401
402	/**
403	* Set last modification UUID of a disk image.
404	*
405	* @returns VBox status code.
406	* @param pBackendData Opaque state data for this image.
407	* @param pUuid Where to get the image modification UUID from.
408	*/
409	DECLR3CALLBACKMEMBER(int, pfnSetModificationUuid, (void *pBackendData, PCRTUUID pUuid));
410
411	/**
412	* Get parent UUID of a disk image.
413	*
414	* @returns VBox status code.
415	* @param pBackendData Opaque state data for this image.
416	* @param pUuid Where to store the parent image UUID.
417	*/
418	DECLR3CALLBACKMEMBER(int, pfnGetParentUuid, (void *pBackendData, PRTUUID pUuid));
419
420	/**
421	* Set parent UUID of a disk image.
422	*
423	* @returns VBox status code.
424	* @param pBackendData Opaque state data for this image.
425	* @param pUuid Where to get the parent image UUID from.
426	*/
427	DECLR3CALLBACKMEMBER(int, pfnSetParentUuid, (void *pBackendData, PCRTUUID pUuid));
428
429	/**
430	* Get parent modification UUID of a disk image.
431	*
432	* @returns VBox status code.
433	* @param pBackendData Opaque state data for this image.
434	* @param pUuid Where to store the parent image modification UUID.
435	*/
436	DECLR3CALLBACKMEMBER(int, pfnGetParentModificationUuid, (void *pBackendData, PRTUUID pUuid));
437
438	/**
439	* Set parent modification UUID of a disk image.
440	*
441	* @returns VBox status code.
442	* @param pBackendData Opaque state data for this image.
443	* @param pUuid Where to get the parent image modification UUID from.
444	*/
445	DECLR3CALLBACKMEMBER(int, pfnSetParentModificationUuid, (void *pBackendData, PCRTUUID pUuid));
446
447	/**
448	* Dump information about a disk image.
449	*
450	* @param pBackendData Opaque state data for this image.
451	*/
452	DECLR3CALLBACKMEMBER(void, pfnDump, (void *pBackendData));
453
454	/**
455	* Get a time stamp of a disk image. May be NULL.
456	*
457	* @returns VBox status code.
458	* @param pBackendData Opaque state data for this image.
459	* @param pTimeStamp Where to store the time stamp.
460	*/
461	DECLR3CALLBACKMEMBER(int, pfnGetTimeStamp, (void *pBackendData, PRTTIMESPEC pTimeStamp));
462
463	/**
464	* Get the parent time stamp of a disk image. May be NULL.
465	*
466	* @returns VBox status code.
467	* @param pBackendData Opaque state data for this image.
468	* @param pTimeStamp Where to store the time stamp.
469	*/
470	DECLR3CALLBACKMEMBER(int, pfnGetParentTimeStamp, (void *pBackendData, PRTTIMESPEC pTimeStamp));
471
472	/**
473	* Set the parent time stamp of a disk image. May be NULL.
474	*
475	* @returns VBox status code.
476	* @param pBackendData Opaque state data for this image.
477	* @param pTimeStamp Where to get the time stamp from.
478	*/
479	DECLR3CALLBACKMEMBER(int, pfnSetParentTimeStamp, (void *pBackendData, PCRTTIMESPEC pTimeStamp));
480
481	/**
482	* Get the relative path to parent image. May be NULL.
483	*
484	* @returns VBox status code.
485	* @param pBackendData Opaque state data for this image.
486	* @param pszParentFilename Where to store the path.
487	*/
488	DECLR3CALLBACKMEMBER(int, pfnGetParentFilename, (void pBackendData, char *ppszParentFilename));
489
490	/**
491	* Set the relative path to parent image. May be NULL.
492	*
493	* @returns VBox status code.
494	* @param pBackendData Opaque state data for this image.
495	* @param pszParentFilename Where to get the path from.
496	*/
497	DECLR3CALLBACKMEMBER(int, pfnSetParentFilename, (void pBackendData, const char pszParentFilename));
498
499	/** Returns a human readable hard disk location string given a
500	* set of hard disk configuration keys. The returned string is an
501	* equivalent of the full file path for image-based hard disks.
502	* Mandatory for backends with no VD_CAP_FILE and NULL otherwise. */
503	DECLR3CALLBACKMEMBER(int, pfnComposeLocation, (PVDINTERFACE pConfig, char **pszLocation));
504
505	/** Returns a human readable hard disk name string given a
506	* set of hard disk configuration keys. The returned string is an
507	* equivalent of the file name part in the full file path for
508	* image-based hard disks. Mandatory for backends with no
509	* VD_CAP_FILE and NULL otherwise. */
510	DECLR3CALLBACKMEMBER(int, pfnComposeName, (PVDINTERFACE pConfig, char **pszName));
511
512	/**
513	* Compact the image. The pointer may be NULL, indicating that this
514	* isn't supported yet (for file-based images) or not necessary.
515	*
516	* @returns VBox status code.
517	* @returns VERR_NOT_SUPPORTED if this image cannot be compacted yet.
518	* @param pBackendData Opaque state data for this image.
519	* @param uPercentStart Starting value for progress percentage.
520	* @param uPercentSpan Span for varying progress percentage.
521	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
522	* @param pVDIfsImage Pointer to the per-image VD interface list.
523	* @param pVDIfsOperation Pointer to the per-operation VD interface list.
524	*/
525	DECLR3CALLBACKMEMBER(int, pfnCompact, (void *pBackendData,
526	unsigned uPercentStart, unsigned uPercentSpan,
527	PVDINTERFACE pVDIfsDisk,
528	PVDINTERFACE pVDIfsImage,
529	PVDINTERFACE pVDIfsOperation));
530
531	/**
532	* Resize the image. The pointer may be NULL, indicating that this
533	* isn't supported yet (for file-based images) or not necessary.
534	*
535	* @returns VBox status code.
536	* @returns VERR_NOT_SUPPORTED if this image cannot be resized yet.
537	* @param pBackendData Opaque state data for this image.
538	* @param cbSize New size of the image.
539	* @param pPCHSGeometry Pointer to the new physical disk geometry <= (16383,16,63). Not NULL.
540	* @param pLCHSGeometry Pointer to the new logical disk geometry <= (x,255,63). Not NULL.
541	* @param uPercentStart Starting value for progress percentage.
542	* @param uPercentSpan Span for varying progress percentage.
543	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
544	* @param pVDIfsImage Pointer to the per-image VD interface list.
545	* @param pVDIfsOperation Pointer to the per-operation VD interface list.
546	*/
547	DECLR3CALLBACKMEMBER(int, pfnResize, (void *pBackendData,
548	uint64_t cbSize,
549	PCVDGEOMETRY pPCHSGeometry,
550	PCVDGEOMETRY pLCHSGeometry,
551	unsigned uPercentStart, unsigned uPercentSpan,
552	PVDINTERFACE pVDIfsDisk,
553	PVDINTERFACE pVDIfsImage,
554	PVDINTERFACE pVDIfsOperation));
555
556	/**
557	* Try to repair the given image.
558	*
559	* @returns VBox status code.
560	* @param pszFilename Name of the image file.
561	* @param pVDIfsDisk Pointer to the per-disk VD interface list.
562	* @param pVDIfsImage Pointer to the per-image VD interface list.
563	* @param fFlags Combination of the VD_REPAIR_* flags.
564	*/
565	DECLR3CALLBACKMEMBER(int, pfnRepair, (const char *pszFilename, PVDINTERFACE pVDIfsDisk,
566	PVDINTERFACE pVDIfsImage, uint32_t fFlags));
567
568	} VBOXHDDBACKEND;
569
570	/** Pointer to VD backend. */
571	typedef VBOXHDDBACKEND *PVBOXHDDBACKEND;
572
573	/** Constant pointer to VD backend. */
574	typedef const VBOXHDDBACKEND *PCVBOXHDDBACKEND;
575
576	/** @copydoc VBOXHDDBACKEND::pfnComposeLocation */
577	DECLINLINE(int) genericFileComposeLocation(PVDINTERFACE pConfig, char **pszLocation)
578	{
579	*pszLocation = NULL;
580	return VINF_SUCCESS;
581	}
582	/** @copydoc VBOXHDDBACKEND::pfnComposeName */
583	DECLINLINE(int) genericFileComposeName(PVDINTERFACE pConfig, char **pszName)
584	{
585	*pszName = NULL;
586	return VINF_SUCCESS;
587	}
588
589	/** Initialization entry point. */
590	typedef DECLCALLBACK(int) VBOXHDDFORMATLOAD(PVBOXHDDBACKEND *ppBackendTable);
591	typedef VBOXHDDFORMATLOAD *PFNVBOXHDDFORMATLOAD;
592	#define VBOX_HDDFORMAT_LOAD_NAME "VBoxHDDFormatLoad"
593
594	/** The prefix to identify Storage Plugins. */
595	#define VBOX_HDDFORMAT_PLUGIN_PREFIX "VBoxHDD"
596	/** The size of the prefix excluding the '\\0' terminator. */
597	#define VBOX_HDDFORMAT_PLUGIN_PREFIX_LENGTH (sizeof(VBOX_HDDFORMAT_PLUGIN_PREFIX)-1)
598
599	#endif

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

source: vbox/trunk/include/VBox/vd-plugin.h@ 48743

Download in other formats: