Share via


IWMPGraphCreation::GetGraphCreationFlags method (wmpservices.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.]

One of the flags documented on this page is available in Windows Media Player 10 and Windows Media Player 11 running on Microsoft Windows XP. It might not be available in subsequent versions.

The GetGraphCreationFlags method is called by Windows Media Player to retrieve a value that represents the graph creation preferences.

Syntax

HRESULT GetGraphCreationFlags(
  [out] DWORD *pdwFlags
);

Parameters

[out] pdwFlags

Address of a DWORD variable that receives a value that represents one or more graph creation flags combined by using bitwise OR operations.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Value Description
S_OK The method succeeded.

Remarks

The following table describes the graph creation flags.

Flag Value Description
WMPGC_FLAGS_ALLOW_PREROLL 0x1 Windows Media Player will build the filter graph for the next media item before the current media item finishes playing.
WMPGC_FLAGS_SUPPRESS_DIALOGS 0x2 Windows Media Player will not display warning dialog boxes when errors occur.
WMPGC_FLAGS_IGNORE_AV_SYNC 0x4 Windows Media Player will not require audio and video to be synchronized when playing Windows Media-based content (.asf, .wma, or .wmv). Windows Media Player will attempt to play every frame of video. This occurs even when video data is arriving more slowly than audio data.
Note  This flag is supported only in Windows Media Player 10 or 11 running on Microsoft Windows XP.
 
WMPGC_FLAGS_DISABLE_PLUGINS 0x8 Disables all plug-ins for the current instance of the Windows Media Player control. This includes plug-ins native to Windows Media Player. For example, visualizations will not work when this flag is set.
WMPGC_FLAGS_USE_CUSTOM_GRAPH 0x10 Windows Media Player will use the application-provided DirectShow graph as-is and not attempt to further render the originally requested URL or file. Plug-ins will still be added to the custom graph unless the WMPGC_FLAGS_DISABLE_PLUGINS flag is also set. Set both these flags if you want WMP to use the provided graph without any changes. Requires Windows Media Player 12.
 

Windows Media Player 10 Mobile: This method is not supported.

Requirements

Requirement Value
Minimum supported client Windows Media Player 10 or later
Target Platform Windows
Header wmpservices.h
DLL Wmp.dll

See also

IWMPGraphCreation Interface