IAudioSessionControl::GetIconPath-Methode (audiopolicy.h)

  • Artikel

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
E_POINTER
 Der Parameter pRetVal ist NULL.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
AUDCLNT_E_DEVICE_INVALIDATED
 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.
AUDCLNT_E_SERVICE_NOT_RUNNING
 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

Weitere Informationen

IAudioSessionControl-Schnittstelle

IAudioSessionControl::SetIconPath