Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
.gif)
| Previous | Next |
IWMPMediaPluginRegistrar::WMPRegisterPlayerPlugin
The IWMPMediaPluginRegistrar::WMPRegisterPlayerPlugin function adds information to the registry that identifies a Windows Media Player plug-in.
Syntax
Parameters
pwszFriendlyName
Pointer to a wide-character null-terminated string containing the friendly name of the plug-in. This is also the name that is displayed to the user.
pwszDescription
Pointer to a wide-character null-terminated string containing the description of the plug-in. This information also is displayed to the user.
pwszUninstallString
Pointer to a wide-character null-terminated string containing the uninstall string.
dwPriority
Integer value containing the priority position of the plug-in in the chain of currently enabled plug-ins.
guidPluginType
GUID specifying plug-in type. For rendering plug-ins, specify WMP_PLUGINTYPE_RENDERING.
clsid
The class ID of the plug-in.
cMediaTypes
Count of media types supported by the plug-in.
pMediaTypes
Pointer to an array of media types that enumerates the supported media types. Media types are stored as type/subtype pairs.
Return Values
The function returns an HRESULT.
Remarks
Implement this function in the exported DllRegisterServer function.
The uninstall string is a command-line string that Windows Media Player passes as the argument to the Windows ShellExecute function when the user chooses to remove the plug-in by clicking Remove in the Player plug-in configuration dialog box. This gives you a way to execute your own uninstall program that initiates from Windows Media Player.
Rendering plug-ins should specify a value of 1 for dwpriority.
Requirements
Version: Windows Media Player 9 Series or later.
Header: Include wmpservices.h.
Library: Use wmp.dll.
See Also
| Previous | Next |