Compartir a través de


IWMPControls::get_isAvailable 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_isAvailable method indicates whether a specified type of information is available or a specified action can be performed.

Syntax

HRESULT get_isAvailable(
  [in]  BSTR         bstrItem,
  [out] VARIANT_BOOL *pIsAvailable
);

Parameters

[in] bstrItem

BSTR containing one of the following values.

Value Description
currentItem Determines whether the user can set the IWMPControls::put_currentItem method.
currentMarker Determines whether the user can seek to a specific marker.
currentPosition Determines whether the user can seek to a specific position in the file. Some files do not support seeking.
fastForward Determines whether the file supports fast forwarding and whether that functionality can be invoked. Many file types (or live streams) do not support fastForward.
fastReverse Determines whether the file supports fastReverse and whether that functionality can be invoked. Many file types (or live streams) do not support fastReverse.
next Determines whether the user can seek to the next entry in a playlist.
pause Determines whether the IWMPControls::pause method is available.
play Determines whether the IWMPControls::play method is available.
previous Determines whether the user can seek to the previous entry in a playlist.
step Determines whether the IWMPControls2::step method is available during playback.
stop Determines whether the IWMPControls::stop method is available.

[out] pIsAvailable

Pointer to a VARIANT_BOOL indicating whether a specified type of information is available or a specified action can be performed.

Return value

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

Return code Description
S_OK
The method succeeded.

Requirements

Requirement Value
Minimum supported client Windows Media Player 9 Series or later.
Target Platform Windows
Header wmp.h
DLL Wmp.dll

See also

IWMPControls Interface

IWMPControls2::step

IWMPControls::pause

IWMPControls::play

IWMPControls::put_currentItem

IWMPControls::stop