IWMPDVD::get_domain method (wmp.h)
[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.]
The get_domain method retrieves the current domain of the DVD.
Syntax
HRESULT get_domain(
[out] BSTR *strDomain
);
Parameters
[out] strDomain
Pointer to a BSTR that contains one of the following values.
| Value | Description |
|---|---|
| firstPlay | Performing default initialization of a DVD disc. |
| videoManagerMenu | Displaying menus for the entire disc. Also known as topMenu for Windows Media Player. Commonly called the title menu or the top menu. |
| videoTitleSetMenu | Displaying menus for current title set. Also known as titleMenu for Windows Media Player. Commonly called the root menu. |
| title | Usually displaying the current title. |
| stop | The DVD Navigator is in the DVD Stop domain. |
| undefined | Windows Media Player is not in any DVD domain. |
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
Remarks
Every DVD is authored differently. Some DVDs do not contain the firstPlay, videoManagerMenu, or videoTitleSetMenu domains.
Windows Media Player 10 Mobile: This method always retrieves a BSTR containing an empty string.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only],Windows Media Player 9 Series or later. |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | wmp.h |
| DLL | Wmp.dll |