File: Core\CSharp\System\Windows\Media\FactoryMaker.cs
Project: wpf\src\PresentationCore.csproj (PresentationCore)
//------------------------------------------------------------------------------
//  Microsoft Avalon
//  Copyright (c) Microsoft Corporation, 2003
//
//  File:       FactoryMaker.cs
//
//------------------------------------------------------------------------------
using System;
using System.Security;
using System.Security.Permissions;
using System.Diagnostics;
using MS.Internal;
using MS.Win32;
using System.Windows.Media.Composition;
using Microsoft.Internal;
 
using SR=MS.Internal.PresentationCore.SR;
using SRID=MS.Internal.PresentationCore.SRID;
using UnsafeNativeMethods=MS.Win32.PresentationCore.UnsafeNativeMethods;
 
namespace System.Windows.Media
{
    /// <summary>
    /// This is a internal class which is used by non context affinity objects
    /// to get access to a MIL factory object.
    /// </summary>
    internal class FactoryMaker: IDisposable
    {
 
        private bool _disposed = false;
        /// <SecurityNote>
        /// Critical - Create unmanaged critical resource 
        /// </SecurityNote>
        [SecurityCritical]
        internal FactoryMaker()
        {
            lock (s_factoryMakerLock)
            {
                // If we haven't have a factory, create one
 
                if (s_pFactory == IntPtr.Zero)
                {
                    // Create the Core MIL factory.
                    // Note: the call below might throw exception. The caller
                    // should catch it. We won't add ref counter here if this
                    // happens.
 
                    HRESULT.Check(UnsafeNativeMethods.MILFactory2.CreateFactory(out s_pFactory, MS.Internal.Composition.Version.MilSdkVersion));
                }
 
                s_cInstance++;
                _fValidObject = true;
            }
        }
 
        ~FactoryMaker()
        {
            Dispose(false);
        }
 
        /// <summary>
        /// Dispose of any resources
        /// </summary>
        public void Dispose()
        {
                Dispose(true);
        }
 
        ///<SecurityNote>
        ///     Critical - performs an elevation to call MILUnknown.ReleaseInterface. 
        ///     TreatAsSafe - this function elevates to call release ( on an object we own). 
        ///                          net effect is a shutdown of the FactoryMaker. Considered safe. 
        ///</SecurityNote> 
        [SecurityCritical, SecurityTreatAsSafe]
        protected virtual void Dispose(bool fDisposing)
        {
                if (!_disposed)
                {
                    if (_fValidObject == true)
                    {
                        lock (s_factoryMakerLock)
                        {
                            s_cInstance--;
 
                            // Make sure we don't dispose twice
                            _fValidObject = false;
 
                            // If there is no FactoryMaker object out there, release
                            // factory object
 
                            if (s_cInstance == 0)
                            {
                                UnsafeNativeMethods.MILUnknown.ReleaseInterface(ref s_pFactory);
 
                                if (s_pImagingFactory != IntPtr.Zero)
                                {
                                    UnsafeNativeMethods.MILUnknown.ReleaseInterface(ref s_pImagingFactory);
                                }
 
                                s_pFactory = IntPtr.Zero;
                                s_pImagingFactory = IntPtr.Zero;
                            }
                        }
                    }
 
                                
                // Set the sentinel.
                _disposed = true;
   
                // Suppress finalization of this disposed instance.
                if (fDisposing)
                {
                    GC.SuppressFinalize(this);
                }
                }
        }
 
        /// <SecurityNote>
        /// Critical - returns critical resource created under an assert
        /// </SecurityNote>
        internal IntPtr FactoryPtr
        {
            [SecurityCritical]
            get
            {
                Debug.Assert(s_pFactory != IntPtr.Zero);
                return s_pFactory;
            }
        }
 
        /// <SecurityNote>
        /// Critical - calls unmanaged code, returns unmanaged pointer
        /// </SecurityNote>
        internal IntPtr ImagingFactoryPtr
        {
            [SecurityCritical]
            get
            {
                if (s_pImagingFactory == IntPtr.Zero)
                {
                    lock (s_factoryMakerLock)
                    {
                        HRESULT.Check(UnsafeNativeMethods.WICCodec.CreateImagingFactory(UnsafeNativeMethods.WICCodec.WINCODEC_SDK_VERSION, out s_pImagingFactory));
                    }
                }
                Debug.Assert(s_pImagingFactory != IntPtr.Zero);
                return s_pImagingFactory;
            }
        }
 
        /// <SecurityNote>
        /// Critical - this is a pointer to an unmanaged object that methods are called directly on
        /// </SecurityNote>
        [SecurityCritical]
        private static IntPtr s_pFactory;
        /// <SecurityNote>
        /// Critical - this is a pointer to an unmanaged object that methods are called directly on
        /// </SecurityNote>
        [SecurityCritical]
        private static IntPtr s_pImagingFactory;
 
        /// <summary>
        /// Keeps track of how many instance of current object have been passed out
        /// </summary>
        private static int s_cInstance = 0;
 
        /// <summary>
        /// "FactoryMaker" is free threaded. This lock is used to synchronize
        /// access to the FactoryMaker.
        /// </summary>
        private static object s_factoryMakerLock = new object();
        private bool _fValidObject;
    }
}