Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetIconPath-Methode ruft den Pfad für das Anzeigesymbol für die Audiositzung ab.
Syntax
HRESULT GetIconPath(
[out] LPWSTR *pRetVal
);
Parameter
[out] pRetVal
Zeiger auf eine Zeigervariable, in die die -Methode die Adresse einer null-beendeten breitzeichenigen Zeichenfolge schreibt, die den vollqualifizierten Pfad einer .ico-, .dll- oder .exe-Datei angibt, die das Symbol enthält. Die -Methode weist den Speicher für die Zeichenfolge zu. Der Aufrufer ist für das Freigeben des Speichers verantwortlich, wenn er nicht mehr benötigt wird, indem er die CoTaskMemFree-Funktion aufruft . Informationen zu Symbolpfaden und CoTaskMemFree finden Sie in der Windows SDK-Dokumentation.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Parameter pRetVal ist NULL. |
|
Nicht genügend Arbeitsspeicher. |
|
Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht. |
|
Der Windows-Audiodienst wird nicht ausgeführt. |
Hinweise
Wenn ein Client nicht IAudioSessionControl::SetIconPath aufgerufen hat, um das Anzeigesymbol festzulegen, ist die Zeichenfolge leer. Wenn kein clientseitig angegebenes Symbol verfügbar ist, verwendet das Sndvol-Programm das Symbol aus dem Anwendungsfenster des Clients, um die Lautstärkesteuerung für die Audiositzung zu bezeichnen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audiopolicy.h |