Windows Media Player SDK banner art
PreviousNext

Effects::GetCapabilities

The GetCapabilities method gets the capabilities of the visualization.

Syntax

HRESULT GetCapabilities(
  DWORD *pdwCapabilities
);

Parameters

  pwdCapabilities

[out]  DWORD containing the capabilities..

The current values are:

Value Description
EFFECT_CANGOFULLSCREEN = 0x00000001; The visualization is capable of full-screen rendering.
EFFECT_HASPROPERTYPAGE = 0x00000002; The visualization has a property page.
EFFECT_VARIABLEFREQSTEP = 0x00000004; The visualization will use frequency data with variable size steps. If this bit is set, step size is based on the media sampling frequency divided by BUFFER_SIZE. If this bit is not set and media is played that was sampled at a low frequency, the upper cells will be empty. For example, if an 8KHz sampled file is played and this bit is not set, the upper half of the frequency array (from 8KHz to 22KHz) will be empty. If this bit is set and an 8Khz sampled file is played, the frequency array will range from 20Hz to 8KHz in BUFFER_SIZE steps.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

A default implementation of this method is not included in the visualization wizard.

See Also

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.