Initialize Cast Media for cast_media_unittests

chromecast/public/cast_media_shlib.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROMECAST_PUBLIC_CAST_MEDIA_SHLIB_H_
 #define CHROMECAST_PUBLIC_CAST_MEDIA_SHLIB_H_
 
 #include <string>
 #include <vector>
 
 #include "chromecast_export.h"
 
 namespace chromecast {
 namespace media {
 
+// Provides access to platform-specific media systems and hardware resources.
+// In cast_shell, all usage is from the browser process.  An implementation is
+// assumed to be in an uninitialized state initially.  When uninitialized, no
+// API calls will be made except for Initialize, which brings the implementation
+// into an initialized state.  A call to Finalize returns the implementation to
+// its uninitialized state.  The implementation must support multiple
+// transitions between these states, to support resource grant/revoke events and
+// also to allow multiple unit tests to bring up the media systems in isolation
+// from other tests.
 class CHROMECAST_EXPORT CastMediaShlib {
  public:
-  // Performs platform-specific one-time initialization for media systems and
-  // hardware resources. Called at startup in browser process before main
-  // message loop begins.
+  // Initializes platform-specific media systems.  Only called when in an
+  // uninitialized state.
   static void Initialize(const std::vector<std::string>& argv);
 
-  // Performs platform-specific one-time teardown of media systems and hardware
-  // resources. Called at browser process exit.
+  // Tears down platform-specific media systems and returns to the uninitialized
+  // state.  The implementation must release all media-related hardware
+  // resources.
   static void Finalize();
 };
 
 }  // namespace media
 }  // namespace chromecast
 
 #endif  // CHROMECAST_PUBLIC_CAST_MEDIA_SHLIB_H_