IMFAudioPolicy::SetIconPath-Methode (mfidl.h)
Legt die Symbolressource für die Audiositzung fest. Das Windows-Lautstärkesteuerelement zeigt dieses Symbol an.
Syntax
HRESULT SetIconPath(
[in] LPCWSTR pszPath
);
Parameter
[in] pszPath
Eine Breitzeichenzeichenfolge, die das Symbol angibt. Siehe Hinweise.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Der Symbolpfad hat das Format "path,index" oder "path,-id", wobei path der vollqualifizierte Pfad zu einer DLL, ausführbaren Datei oder Symboldatei ist. index ist der nullbasierte Index des Symbols in der Datei. und id ist ein Ressourcenbezeichner. Beachten Sie, dass Ressourcenbezeichnern ein Minuszeichen (-) vorangestellt sind, um sie von Indizes zu unterscheiden. Der Pfad kann Umgebungsvariablen wie "%windir%" enthalten. Weitere Informationen finden Sie unter IAudioSessionControl::SetIconPath im Windows SDK.
Beispiele
Im folgenden Beispiel wird das Symbol mithilfe eines Ressourcenbezeichners für ein Symbol in der ausführbaren Datei der Anwendung festgelegt.
HRESULT SetIcon(IMFMediaSession *pSession, int nID)
{
IMFAudioPolicy *pPolicy = NULL;
const DWORD CCH_ICON_PATH = MAX_PATH + 16;
WCHAR szFileName[MAX_PATH];
WCHAR szIconPath[CCH_ICON_PATH];
HRESULT hr = S_OK;
DWORD result = GetModuleFileNameW(NULL, szFileName, MAX_PATH);
// Note: GetModuleFileName can return a truncated string without a
// NULL terminator. If so, the function succeeds but sets the last
// error to ERROR_INSUFFICIENT_BUFFER.
if ((result == 0) || (GetLastError() == ERROR_INSUFFICIENT_BUFFER))
{
hr = E_FAIL;
goto done;
}
hr = StringCchPrintfW(szIconPath, CCH_ICON_PATH,
L"%s,-%d", szFileName, nID);
if (FAILED(hr))
{
goto done;
}
hr = MFGetService(
pSession,
MR_AUDIO_POLICY_SERVICE,
IID_PPV_ARGS(&pPolicy)
);
if (FAILED(hr))
{
goto done;
}
hr = pPolicy->SetIconPath(szIconPath);
if (FAILED(hr))
{
goto done;
}
done:
SafeRelease(&pPolicy);
return hr;
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |
| Bibliothek | Mfuuid.lib |