WMEncoder SDK二次开发

创建再分发安装

1. 调用再分发程序包之前，请首先让您的安装例程安装您的应用程序文件，并进行所需的设置。

2. 安装WMFDist.exe。您可以使用/Q:A 标志执行安静的无人参与安装，并在应用程序（例

如：WMFDist.exe /Q:A ）安装期间不显示再分发安装的用户界面。然后您的例程必须检测结束时是否需要重新启动重新启动。

WMFdist.exe 命令行参数

将WMFDist.exe 作为应用程序的一部分进行安装时，管理员或开发人员可以通过使用下列命令，来控制安装UI 显示和重新启动重新启动行为：

WMFdist.exe /Q:A

此命令指定无人参与安装，并且不出现任何UI 或警告。

注下一节中的代码示例说明了如何在程序包运行结束之后确定成功还是失败，以及是否需要重新启动。

检测WMFDist.exe 的安装状态

下面的代码可用于Windows Media Format SDK runtime 再分发或Windows Media Player 再分发程序包。

安装状态将作为HRESULT存储在下列位置：

HKCU, Software\Microsoft\MediaPlayer\Setup, REG_SZ, value InstallResult HRESULT值可用于确定安装是否成功以及是否需要重新启动。

下面的C++ 示例代码可包含在一个调用安装应用程序中。此代码会根据组件再分发程序包中Windows Media 安装写入的HRESULT值，将fSuccess和fRebootNeeded变量设置为合适的true 或false。

1#include

2#include

3

4// If NS_S_REBOOT_REQUIRED is undefined, use 0xD2AF9.

5#ifndef NS_S_REBOOT_REQUIRED

6#define NS_S_REBOOT_REQUIRED 0xd2af9

7#endif

8

9int main( void )

10{

11 HKEY hKey = NULL;

12 BOOL fSuccess = FALSE;

13 BOOL fRebootNeeded = FALSE;

14

15if( ERROR_SUCCESS == RegOpenKeyExA(

16 HKEY_CURRENT_USER,

17"Software\\Microsoft\\MediaPlayer\\Setup ",

180, KEY_QUERY_VALUE, &hKey ))

19 {

20char szResult[64];

21 DWORD dwResult = sizeof( szResult );

22

23if( ERROR_SUCCESS == RegQueryValueExA(

24 hKey, "InstallResult", NULL, NULL,

25 (LPBYTE)szResult, &dwResult ) )

26 {

27 sscanf( szResult, "%x", &dwResult );

28 fSuccess = SUCCEEDED( dwResult );

29 fRebootNeeded = ( NS_S_REBOOT_REQUIRED == dwResult );

30 }

31

32 RegCloseKey( hKey );

33 }

34

35if( fSuccess )

36 {

37 printf( "Setup Succeeded" );

38if( fRebootNeeded )

39 printf( "A restart IS required\n" );

40else

41 printf( "A restart IS NOT required\n" );

42 }

43else

44 {

45 printf( "Setup Failed" );

46if( fRebootNeeded )

47 printf( "A restart IS required\n" );

48else

49 printf( "A restart IS NOT required\n" );

50 }

51

52return0;

53}

54

如果要将再分发程序包包括在您的应用程序中，则当您在安装例程中调用该再分发程序包时，可以使用/Q:A 标志。这样会抑制用户界面(UI) 的显示。因为WMFdist.exe 程序包的设计意图就是为了用于软件再分发，所以该程序包会抑制自动重新启动，不会通过用户界面返回或通知用户重新启动情况。请确保使用返回注册表的信息来执行下列操作：

?确定在运行WMFdist.exe 之后计算机是否需要重新启动。

?处理需要重新启动的情况，以及需要重新启动时与最终用户的通信。

下面的示例代码可在您的安装例程中用来以安静模式运行再分发程序包，并在计算机必须重新启动时通知您的安装例程。

1/////////////////////////////////////////////////////////////// ////////

2//

3// MUST ADD:

5// You must add "shlwapi.lib" to your project settings (link)

6//

7/////////////////////////////////////////////////////////////// ////////

8

9#include

10#include

11#include

12#include

13using std::cout;

14using std::endl;

15

16#define MAX_TIMEOUT_MS 30 * 60 * 1000

17#define TIME_INCREMENT 250

18

19// Prototypes

20BOOL GoInstallWMRedist( BOOL );

21BOOL SystemNeedsReboot( void );

22

23void main( void )

24{

25 GoInstallWMRedist( TRUE );

26

27 cout << "Setup is complete";

28

29if( SystemNeedsReboot() )

30 {

31// Write some code here to ensure that your applicatio

n will

32 // restart the computer, and delay dll registrations an

33 // until after the restart, where possible. For exampl e,

34 // set a global flag for use by the application.

35 cout << "A restart IS required" << endl;

36 }

37else

38 cout << "A restart IS NOT required" << endl;

39

40}

41

42/////////////////////////////////////////////////////////////// ////////

43//

44// Usage:

45//

46// Takes one parameter (BOOL)

47//

48// If you want to wait for completion, pass TRUE,

49// else pass FALSE.

50//

51/////////////////////////////////////////////////////////////// ////////

52BOOL GoInstallWMRedist( BOOL fWaitForCompletion )

53/////////////////////////////////////////////////////////////// ////////

54{

55 STARTUPINFO StartUpInfo;

56 PROCESS_INFORMATION ProcessInfo;

57

58 StartUpInfo.cb = sizeof( StartUpInfo );

59 StartUpInfo.lpReserved = NULL;

60 StartUpInfo.dwFlags = 0;

61 StartUpInfo.cbReserved2 = 0;

62 StartUpInfo.lpReserved2 = NULL;

63 StartUpInfo.lpDesktop = NULL;

64 StartUpInfo.lpTitle = NULL;

65 StartUpInfo.dwX = 0;

66 StartUpInfo.dwY = 0;

67 StartUpInfo.dwXSize = 0;

68 StartUpInfo.dwYSize = 0;

69 StartUpInfo.dwXCountChars = 0;

70 StartUpInfo.dwYCountChars = 0;

71 StartUpInfo.dwFillAttribute = 0;

72 StartUpInfo.dwFlags = 0;

73 StartUpInfo.wShowWindow = 0;

74 StartUpInfo.hStdInput = NULL;

75 StartUpInfo.hStdOutput = NULL;

76 StartUpInfo.hStdError = NULL;

77

78// Run the installer with the Quiet for All and Reboot:Neve r

79 // flags. The installation should be silent, and the setup r outine

80 // will be notified whether the computer must be restarted. 81

82if( !CreateProcess( _T("c:\\temp\\WMFDist.exe"),

83 _T("c:\\temp\\WMFDist.exe /Q:A"), NULL, NULL, FALS E,

840, NULL, NULL, &StartUpInfo, &ProcessInfo ) )

85 {

86 DWORD myError = GetLastError();

87return( FALSE );

88 }

89

90 CloseHandle( ProcessInfo.hThread );

91

92if( fWaitForCompletion )

93 {

94 DWORD dwTimePassed = 0;

95while( TRUE )

96 {

97if( WAIT_TIMEOUT != WaitForMultipleObjects(

981, &ProcessInfo.hProcess, FALSE, TIME_INCREMEN

T ) )

99break;

100

101if( dwTimePassed > MAX_TIMEOUT_MS )

102 {

103 TerminateProcess( ProcessInfo.hProcess, E_FAIL ); 104break;

105 }

106 dwTimePassed += TIME_INCREMENT;

107 }

108 }

109 CloseHandle( ProcessInfo.hProcess);

110

111return( TRUE );

112}

113

114///////////////////////////////////////////////////////////////

////////

115//

116// Used to determine whether the system should be restarted

117//

118/////////////////////////////////////////////////////////////// ////////

119BOOL SystemNeedsReboot( void )

120/////////////////////////////////////////////////////////////// ////////

121{

122 BOOL fNeedExists = FALSE;

123 OSVERSIONINFO osvi;

124

125 osvi.dwOSVersionInfoSize = sizeof( OSVERSIONINFO );

126 GetVersionEx( &osvi );

127

128if( VER_PLATFORM_WIN32_NT != osvi.dwPlatformId )

129 {

130 TCHAR szIniPath[MAX_PATH];

131

132 GetWindowsDirectory(szIniPath,

133sizeof(szIniPath)/sizeof(TCHAR));

134 PathAddBackslash( szIniPath );

135 _tcscat( szIniPath, _T("wininit.ini") );

136

137if( 0xFFFFFFFF != GetFileAttributes( szIniPath ) )

138 {

139 HFILE hFile;

140

141if( (hFile =

142 _lopen(szIniPath,OF_READ|OF_SHARE_DENY_NONE))! =

143 HFILE_ERRO

R )

144 {

145 fNeedExists = ( 0 != _llseek(hFile, 0L, FILE_EN

D) );

146 _lclose(hFile);

147 }

148 }

149 }

150else

151 {

152 HKEY hKey = NULL;

153

154if( ERROR_SUCCESS == RegOpenKeyEx( HKEY_LOCAL_MACHINE, 155 _T("System\\CurrentControlSet\\Control\\Session Mana ger"),

1560, KEY_READ, &hKey ) )

157 {

158if( ERROR_SUCCESS == RegQueryValueEx( hKey,

159 _T("PendingFileRenameOperations"),

160 NULL, NULL, NULL, NULL))

161 {

162 fNeedExists = TRUE;

163 }

164

165 RegCloseKey( hKey );

166 }

167 }

168

169return( fNeedExists );

170}

再分发Windows Media Encoder 9 Series 软件

当您分发基于Windows Media Encoder SDK 的应用程序时，必须通过在安装中再分发Windows Media Encoder，或者要求您的用户自行安装Windows Media Encoder，将Windows Media Encoder 软件也包括在内。

如果您要再分发Windows Media Encoder，则必须在安装中包括并运行WMEncoder.exe 安装文件。Microsoft 网站的下载中心中提供有此文件。如果您希望最终用户自行安装Windows Media Encoder，则可以引导这些用户访问此网站。

默认情况下，Windows Media Encoder 安装在C:\Program Files\Windows Media Components\Encoder 目录中。

WMEncoder.exe 命令行参数

下面几项内容显示了WMEncoder.exe 常用的命令行参数。

对于不带UI 的无人参与安装：

wmencoder.exe /Q:A

对于带有进度条的无人参与安装：

wmencoder.exe /Q

检测Windows Media Encoder 9 Series

您可以通过搜索注册表的方式，确定所安装的Windows Media Encoder 的版本：HKLM, Software\Microsoft\Windows Media\Encoder, "Version"

在该编码器项下面，如果设置了Version 字符串值，则可以放心地使用该字符串值作为所安装的Windows Media Encoder 的版本。

您可以使用下列注册表项来确定Windows Media Encoder 安装目录的位置：

HKLM, Software\Microsoft\Windows Media\Encoder, "InstallDir"

再分发Windows Media Player 9 Series 软件

在应用程序中检测Windows Media Player

您可以通过搜索注册表的方式，确定所安装的Windows Media Player 的版本。

HKEY_LOCAL_MACHINE\Software\Microsoft\Active Setup\Installed Components

对于Windows Media Player 6.4，请查看该项：

"{22d6f312-b0f6-11d0-94ab-0080c74c7e95}"

对于Windows Media Player 7、Windows Media Player for Windows? XP 或Windows Media Player 9 Series，请查看该项：

"{6BF52A52-394A-11d3-B153-00C04F79FAA6}"

在上述任一项下面，如果IsInstalled DWORD值设置为0x1，则可以放心地使用“Version”字符串值作为所安装的Windows Media Player 的版本。

MPSetup.exe 和MPSetupXP.exe 命令行参数

下面是几个常用的命令行参数。

对于不带UI、不需要重新启动或没有重新启动提示的无人参与安装：

mpsetup.exe /q:A /c:"setup_wm.exe /Q:A /R:N /P:#e"

这是一个标准的命令行，通常应该用于执行无人参与安装。

防止媒体库移植：

mpsetup.exe /q:A /R:N /c:"setup_wm.exe /NoMigrate /P:#e"

对安装程序包进行缓存，用于以后的Windows 升级移植：

mpsetup.exe /q:A /R:N /c:"setup_wm.exe /P:#e"

/P:#e 指定，在Windows Media Player 安装过程中应该对Windows Media Player 安装程序包进行缓存。在处理操作系统将来升级的所有命令行中，通常应该使用此参数。不应在命令行中包括/P:#e 的唯一一种情况为，您知道目标系统永远不会升级为更高版本的操作系统。例如，如果您正在Windows 2000 上安装Windows Media Player 9 Series，并且该计算机在将来的某一天可能会升级为Windows XP，则必须在命令行中使用/P:#e。如果不使用此参数，则在Windows XP 安装之后，Windows Media Player 9 Series 文件会被Windows Media Player for Windows XP 的文件所覆盖。

对于安静模式：

/Q

此参数用于不带UI 的无人参与安装。

取消重新启动提示：

/R:N

此参数表示永远不需要重新启动，也不出现提示。如果您忽略此命令，则无论是否已经安装该软件，播放器都会在安装结束时提示用户重新启动计算机。

创建嵌套的系统还原点：

/NestedRestore

如果您的应用程序创建的系统还原点会将Windows Media Player 还原点嵌套在应用程序还原点中，请使用此参数。

不允许创建系统还原点

/DisallowSystemRestore

此标志会禁止系统还原点的创建。大多数情况下，对于一般的软件再分发方案都不应该使用此标志。只有当您可以代表最终用户作出明确选择，不支持Windows Media Player 9 Series 文件回滚到该播放器的更早版本时，才应该使用此标志。此标志只应在公司部署或者原始设备制造商(OEM) 安装方案中使用。

注意

?命令行参数区分大小写。

?取消重新启动提示时，必须检查InstallResult 注册表项，并处理调用安装应用程序中的重新启动通知。

?Windows Media Player 9 Series 还会安装Windows Media Format runtime，因此无需将Media Player 9 Series 分发程序包和Windows Media Format Runtime 分发程序包同时包括在一个软件再分发程序包中。例如，如果您在安装中包括了MPSetup.exe 或MPSetupXP.exe，则无需包括WMFdist.exe。

检测MPSetup.exe 和MPSetupXP.exe 的安装状态

下面的代码可用于Windows Media Player 再分发程序包。

安装状态作为HRESULT存储在下列位置：

HKCU, Software\Microsoft\MediaPlayer\Setup, REG_SZ, value InstallResult HRESULT值可用于确定安装是否成功以及是否需要重新启动。

下面的C++ 示例代码可包含在一个调用安装应用程序中。此代码会根据组件再分发程序包中Windows Media 安装写入的HRESULT值，将fSucess和fRebootNeeded变量设置为合适的true 或false。

1#include

2#include

3

4// If NS_S_REBOOT_REQUIRED is undefined, use 0xD2AF9.

5#ifndef NS_S_REBOOT_REQUIRED

6#define NS_S_REBOOT_REQUIRED 0xd2af9

7#endif

8

9int main( void )

10{

11 HKEY hKey = NULL;

12 BOOL fSuccess = FALSE;

13 BOOL fRebootNeeded = FALSE;

14

15if( ERROR_SUCCESS == RegOpenKeyExA(

16 HKEY_CURRENT_USER,

17"Software\\Microsoft\\MediaPlayer\\Setup ",

180, KEY_QUERY_VALUE, &hKey ))

19 {

20char szResult[64];

21 DWORD dwResult = sizeof( szResult );

22

23if( ERROR_SUCCESS == RegQueryValueExA(

24 hKey, "InstallResult", NULL, NULL,

25 (LPBYTE)szResult, &dwResult ) )

26 {

27 sscanf( szResult, "%x", &dwResult );

28 fSuccess = SUCCEEDED( dwResult );

29 fRebootNeeded = ( NS_S_REBOOT_REQUIRED == dwResult );

30 }

31

32 RegCloseKey( hKey );

33 }

34

35if( fSuccess )

36 {

37 printf( "Setup Succeeded" );

38if( fRebootNeeded )

39 printf( "A restart IS required\n" );

40else

41 printf( "A restart IS NOT required\n" );

42 }

43else

44 {

45 printf( "Setup Failed" );

46if( fRebootNeeded )

47 printf( "A restart IS required\n" );

48else

49 printf( "A restart IS NOT required\n" );

50 }

51

52return0;

53}

Windows Media 编码解码器再分发

您可以更新Windows Media Player 7 或Windows Media Player for Windows XP，以使得这些软件不必依赖Internet 代码自动下载机制即可支持Windows Media 9 Series 编码解码器。有一个用于此目的的编码解码器再分发程序包，名为WM9Codecs.exe，该程序包可用于公司和软件部署。

要在应用程序再分发安装中使用这个程序包更新编码解码器，请使用下面的命令行将

WM9Codecs.exe 包括在内，并运行该程序包。

WM9Codecsxe /Q:A

这样会启动不带UI 的无人参与安装。

注意

?您必须使用Windows Media Format runtime 再分发部分中说明的注册表信息，来检查安装成功状态，并确定系统是否需要重新启动来完成安装。

?如果在再分发安装中包括了Windows Media Player 9 Series 或Windows Media Format runtime 分发程序包，则无需包括Windows Media Codecs 安装程序包。

关于主Interop 程序集

使用Microsoft Windows .NET 框架嵌入Windows Media Player 控件的过程需要使用Windows Media Player 主interop 程序集(PIA)。PIA 是一个独特的框架程序集，其中包含了COM 组件所实现的各种类型的类型定义（作为元数据）。只有类型库的发布者才能生成真正的PIA，该PIA 将成为用于与基础COM 类型进行交互的正式类型定义的单元。

有关详细信息，请参阅MSDN 网站上的主Interop 程序集(PIA)。

与您的应用程序一起再分发主Interop 程序集

主Interop 程序集(PIA) 是做为Microsoft Windows .NET 框架应用程序的一部分再分发给最终用户的。包含一个或多个PIA 的应用程序的部署与任何基于 .NET 的应用程序一样，不需要在用户计算机上注册每个相关的COM 类型库。

按照定义，PIA 总是由它们的发布者进行签名，以确保唯一性。按照它们所描述类型的唯一官方定义，您可以希望一些常用的PIA 安装在全局程序集缓存中，即使将这同一个程序集部署到应用程序目录中也可如此。当全局程序集与本地程序集具有相同的供应商签名时，公共语言运行库总是会将您的应用程序指向该全局程序集缓存中的PIA。在这种情况下，您的应用程序不会受到保护，会受供应商发起的版本更改的影响。最佳方法是始终安装供应商提供的最新版本。然而，当您的应用程序需要上述保护时，则可以通过使用类型库导入程序(Tlbimp.exe)（而不是PIA）来生成自己的interop 程序集。

注册用于应用程序开发的主Interop 程序集

您必须使用程序集注册工具(RegAsm.exe) 和全局程序集缓存实用程序(GacUtil.exe) 来注册和安装Windows Media Player PIA。

要注册PIA，请在命令提示符下，键入：

regasm assemblyname

在此命令中，assemblyname为要注册的程序集的文件名。

下面的示例会注册wmppia.dll PIA。

regasm C:\WMSDK\WMPSDK9\redist\wmppia.dll

Regasm.exe 在与原始类型库相同的注册表项下面添加一个用于该PIA 的注册表项。

注册了该PIA 之后，使用全局程序集缓存实用程序将其安装到全局程序集缓存(GAC) 中。要将PIA 安装到GAC 中，请在命令提示符下，键入：

Gacutil /i assemblyname

在此命令中，assemblyname为要安装的程序集的文件名。

下面的示例会在GAC 中安装Windows Media Player PIA。

Gacutil /i C:\WMSDK\WMPSDK9\redist\wmppia.dll

注您应该在计算机中搜索RegAsm.exe 和Gacutil.exe。通常这两个程序位

于%windir%\https://www.360docs.net/doc/904811618.html,\Framework\v1.0.xxxx中（其中xxxx为您正在使用的Windows .NET 框架的版本的内部版本号）或者您在其中安装开发环境的

\FrameworkSDK\Bin 文件夹中。

包含Windows Media Player SDK 完整安装所包含的C# 示例应用程序的文件夹还包含了一个名为regpiagac.vbs 的脚本文件。此实用程序可使得注册PIA 并将其添加到GAC 中的

过程变得十分简单。双击该文件并在出现提示时提供正确的路径，即可完成该过程。如果您使用默认安装路径安装了Windows Media Player SDK 和Visual Studio .NET，则只需更改驱动器盘符。如果没有使用默认路径安装这些产品，则可能会发生非预期的结果。

Windows Media Services 9 Series 软件

Windows Media Services 9 Series 包含了下面两个可再分发的组件，这两个组件可在与Windows Media Services 交互的软件应用程序开发中使用。?WMSServerTypeLib.dll

?microsoft.windowsmediaservices.dll

这两个文件可从Microsoft Platform SDK 通过Windows Media Services 9 Series 组件安装选项获得。安装Microsoft Platform SDK 会同时授予开发人员再分发这两个文件的权利。这两个文件位于Microsoft Windows Platform SDK 安装根文件夹下的\include 目录中。默认情况下，该文件夹为C:\Program Files\Microsoft SDK\include。默认情况下，许可条款位于Microsoft SDK\License 文件夹中。