Edit

File Name Extension Registry Settings

  • Article

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

If your digital media files have a custom format, you can provide Windows Media Player with information about your custom format by placing entries in the registry on the user's computer. Windows Media Player inspects your registry entries to determine how it should handle your files. The following list shows several of the things you can do by creating registry entries that pertain to your custom media file format.

  • Grant permission for the Player to play, copy, or transcode your files.
  • Specify the underlying technology that the Player should use to play your files.
  • Specify where the Player should display your files in its library view.
  • Specify a plug-in that the Player should use to convert your files to a standard format.
  • Specify a Media Transport Protocol (MTP) format code that the Player can use to determine whether a particular portable device supports your file format.

Most of the entries that you provide will be under a subkey that is associated with your custom file name extension. You can create that subkey in the HKEY_LOCAL_MACHINE subtree and in the HKEY_CURRENT_USER subtree. Windows Media Player looks first in the HKEY_LOCAL_MACHINE subtree. If it doesn't find what it needs there, it looks in the HKEY_CURRENT_USER subtree. Note that any code that attempts to write to the registry on the user's computer can write to the HKEY_LOCAL_MACHINE subtree only if the current user has administrative privileges.

To write information about your custom file format to the HKEY_LOCAL_MACHINE subtree, create the following subkey.

HKEY_LOCAL_MACHINE\Software\Microsoft\Multimedia\WMPlayer\Extensions\ customExtension

where customExtension is the file name extension including the dot (.) separator. For example, if the extension for your custom file format is .xyz, create the following subkey.

HKEY_LOCAL_MACHINE\Software\Microsoft\Multimedia\WMPlayer\Extensions\.xyz

To write information about your custom file format to the HKEY_CURRENT_USER subtree, create the following subkey.

HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Player\Extensions\ customExtension

You can write one or more of the following entries in your customExtension subkey.

  • Permissions
  • Runtime
  • FormatCode

To specify conversion plug-ins for your custom media file format, create a ConvertPluginCLSID subkey in your customExtension subkey.

To specify where Windows Media Player should display your files in its library view, write an entry that represents your custom file format in the following subkey.

HKEY_LOCAL_MACHINE\Software\Microsoft\MediaPlayer\MLS\Extensions

The following topics describe the registry subkeys and entries that provide Windows Media Player with information about custom media file formats.

Registry Settings

Windows Media Player Conversion Plug-ins