Metodo IAudioSessionControl::SetIconPath (audiopolicy.h)
Il metodo SetIconPath assegna un'icona di visualizzazione alla sessione corrente.
Sintassi
HRESULT SetIconPath(
[in] LPCWSTR Value,
[in] LPCGUID EventContext
);
Parametri
[in] Value
Puntatore a una stringa di caratteri wide e con terminazione Null che specifica il percorso e il nome file di un file con estensione ico, .dll o .exe che contiene l'icona. Per informazioni sui percorsi delle icone, vedere la documentazione di Windows SDK.
[in] EventContext
Puntatore al GUID del contesto dell'evento. Se una chiamata a questo metodo genera un evento di modifica dell'icona, il gestore sessione invia notifiche a tutti i client che hanno registrato interfacce IAudioSessionEvents con la gestione sessione. La gestione sessione include il valore del puntatore EventContext con ogni notifica. Dopo aver ricevuto una notifica, un client può determinare se è l'origine dell'evento o un altro client controllando il valore EventContext . Questo schema dipende dal client che seleziona un valore per questo parametro univoco tra tutti i client nella sessione. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il valore del parametro è NULL. |
|
Il dispositivo endpoint audio è stato scollegato oppure l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso. |
|
Il servizio audio di Windows non è in esecuzione. |
Commenti
In Windows Vista, il programma fornito dal sistema, Sndvol.exe, usa l'icona di visualizzazione (insieme al nome visualizzato) per etichettare il controllo volume per la sessione. Se il client non chiama SetIconPath per assegnare un'icona alla sessione, il programma Sndvol usa l'icona dalla finestra dell'applicazione come icona predefinita per la sessione.
Nel caso di una sessione tra processi, la sessione non è associata a un singolo processo dell'applicazione. Pertanto, Sndvol non dispone di un'icona specifica dell'applicazione da usare per impostazione predefinita e il client deve chiamare SetIconPath per evitare di visualizzare un'icona senza significato.
L'icona di visualizzazione non persiste oltre la durata dell'oggetto IAudioSessionControl . Pertanto, dopo il rilascio di tutti i riferimenti all'oggetto, una versione creata successivamente dell'oggetto (con la stessa applicazione, lo stesso GUID di sessione e lo stesso dispositivo endpoint) avrà nuovamente un'icona predefinita finché il client non chiama SetIconPath.
Il client può recuperare l'icona di visualizzazione per la sessione chiamando il metodo IAudioSessionControl::GetIconPath .
Requisiti
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | audiopolicy.h |