IMFAudioPolicy::GetIconPath method (mfidl.h)

Retrieves the icon resource for the audio session. The Windows volume control displays this icon.


HRESULT GetIconPath(
  [out] LPWSTR *pszPath


[out] pszPath

Receives a pointer to a wide-character string that specifies a shell resource. The format of the string is described in the topic IMFAudioPolicy::SetIconPath. The caller must free the memory allocated for the string by calling CoTaskMemFree.

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.


If the application did not set an icon path, the method returns an empty string ("").

For more information, see IAudioSessionControl::GetIconPath in the core audio API documentation.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also


Streaming Audio Renderer