During the last months I have been working in a project highly related to multimedia and
client development technologies such as Silverlight. And in the last few weeks, I started to look to some of the new IIS Media services such as Smooth Streaming and Live Smooth Streaming in order to gather as much knowledge about them to perform some spikes for the project.
One of the things that came up while spiking was finding a way to start, stop & shutdown a publishing point via code.
Microsoft.Web.Administration to the Rescue
With IIS7 a new API to administer IIS from managed code was introduced. This API is really simple to use and with a few lines of code you can manipulate the server configuration as any other information available in IIS7. (if you want to taste the power of this API, I recommend you to read this post from Carlos Aguilar Mares).
So, I used the Microsoft.Web.Administration.dll assembly, that can be found at IIS Directory (%windir%\System32\inetSrv), to perform the operations over the publishing point. But it was not so easy to do it, as there is no information available yet about what RSCA function has to be called and which parameters need to be used in order get the desired results.
Then, I started to look at the different IIS configuration files (%windir%\System32\inetsrv\config) searching for clues and I came up with the Microsoft.Web.Management.Media.LiveStreaming.dll assembly (this assembly can be found in the GAC after installing the Live Smooth Streaming bits).
In that moment I summoned my best friend Reflector and together went to the depths of this assembly until we found some code that might be useful for our objective.
After doing some tests, I ended up with the following method:
private static void ExecuteRscaFunction(ConfigurationElement workerProcess,
string siteName, string applicationPath,
string fileName, string functionName)
{
ConfigurationMethod configurationMethod = workerProcess.Methods["GetCustomData"];
ConfigurationMethodInstance instance = configurationMethod.CreateInstance();
instance.Input["guidIdOfFunctionCall"] = “Media_LiveStreaming_Control”;
string currentLogicalPath = applicationPath;
if (!currentLogicalPath.EndsWith(“/”, StringComparison.OrdinalIgnoreCase))
{
currentLogicalPath = currentLogicalPath + “/”;
}
string fullPath = string.Concat(currentLogicalPath, fileName);
string parameters = string.Format(CultureInfo.InvariantCulture, “{0};{1};{2}”,
functionName, siteName, fullPath);
instance.Input["parametersOfFunctionCall"] = parameters;
instance.Execute();
}
|
The most important thing of the method above is the functionName parameter. This parameter can be one the following values depending on what you want to accomplish:
- StartPublishingPoint. This is used to start a publishing point.
- StopPublishingPoint. This is used to stop the live source of the publishing point.
- ShutdownPublishingPoint. This is used to shutdown a publishing point.
To understand where the others parameters should come from, let’s take a look at the following example:
So, if we want to the start the LiveSmoothStream publishing point associated to the SmoothStreaming application from the Default Web Site, we should call the ExecuteRscaFunction method in this way:
ExecuteRscaFunction(workerProcess,
“Default Web Site”, “/SmoothStreaming”,
“LiveSmoothStream.isml”, “StartPublishingPoint”);
|
The remaining parameter (workerProcess) must be retrieved from the application pool associated to the application.
Note: You can use the Microsoft.Web.Administration API to get all the values previously mentioned.
To see if the function is working you can add the following lines of code at the end of the method to parse the output and print it on the console.
string rawOutput = instance.Output["data"] as string;
byte[] bytes = Convert.FromBase64String(rawOutput);
ASCIIEncoding encoding = new ASCIIEncoding();
Console.WriteLine(encoding.GetString(bytes));
|
The output after executing the Stop, Shutdown and Start functions:

Hope this helps!. If you want to learn more about Smooth Streaming you might find useful the following links:
Happy streaming!.
