3 * @brief Common LibVLC objects marshalling utilities
7 /**********************************************************************
8 * Copyright (C) 2007-2009 RĂ©mi Denis-Courmont. *
9 * This program is free software; you can redistribute and/or modify *
10 * it under the terms of the GNU General Public License as published *
11 * by the Free Software Foundation; version 2 of the license, or (at *
12 * your option) any later version. *
14 * This program is distributed in the hope that it will be useful, *
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. *
17 * See the GNU General Public License for more details. *
19 * You should have received a copy of the GNU General Public License *
20 * along with this program; if not, you can get it from: *
21 * http://www.gnu.org/copyleft/gpl.html *
22 **********************************************************************/
25 using System.Runtime.InteropServices;
27 namespace VideoLAN.LibVLC
30 * @brief NonNullHandle: abstract safe handle class for non-NULL pointers
32 * Microsoft.* namespace has a similar class. However we want to use the
33 * System.* namespace only.
35 internal abstract class NonNullHandle : SafeHandle
37 protected NonNullHandle ()
38 : base (IntPtr.Zero, true)
43 * System.Runtime.InteropServices.SafeHandle::IsInvalid.
45 public override bool IsInvalid
49 return handle == IntPtr.Zero;
54 * Destroys an handle. Cannot fail.
56 protected abstract void Destroy ();
59 * System.Runtime.InteropServices.SafeHandle::ReleaseHandle.
61 protected override bool ReleaseHandle ()
70 * @brief BaseObject: generic wrapper around a safe LibVLC handle.
73 * This is the baseline for all managed LibVLC objects. It wraps:
74 * - an unmanaged LibVLC pointer,
75 * - a native exception structure, and
76 * - the object's native event manager.
78 public class BaseObject : IDisposable
80 internal NativeException ex; /**< buffer for LibVLC exceptions */
81 internal SafeHandle handle; /**< wrapped safe handle */
83 internal BaseObject ()
85 ex = new NativeException ();
90 * Checks if the LibVLC run-time raised an exception
91 * If so, raises a CIL exception.
93 internal void Raise ()
99 * IDisposable::Dispose.
101 public void Dispose ()
104 GC.SuppressFinalize (this);
108 * Releases unmanaged resources associated with the object.
109 * @param disposing true if the disposing the object explicitly,
110 * false if finalizing the object inside the GC.
112 protected virtual void Dispose (bool disposing)