IAudioSessionControl::GetIconPath-Methode (audiopolicy.h)
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 |