Metodo IAudioSessionControl::GetIconPath (audiopolicy.h)
Il metodo GetIconPath recupera il percorso dell'icona di visualizzazione per la sessione audio.
Sintassi
HRESULT GetIconPath(
[out] LPWSTR *pRetVal
);
Parametri
[out] pRetVal
Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di una stringa di caratteri null con terminazione null che specifica il percorso completo di un .ico, .dll o .exe file che contiene l'icona. Il metodo alloca l'archiviazione per la stringa. Il chiamante è responsabile della liberazione dell'archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Per informazioni sui percorsi dell'icona e CoTaskMemFree, vedere la documentazione di Windows SDK.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro pRetVal è NULL. |
|
Memoria insufficiente. |
|
Il dispositivo endpoint audio è stato scollegato o 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
Se un client non ha chiamato IAudioSessionControl::SetIconPath per impostare l'icona di visualizzazione, la stringa sarà vuota. Se non è disponibile alcuna icona specificata dal client, il programma Sndvol usa l'icona dalla finestra dell'applicazione del client per etichettare il controllo del volume per la sessione audio.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |