Metodo IAudioSessionControl::GetDisplayName (audiopolicy.h)
Il metodo GetDisplayName recupera il nome visualizzato per la sessione audio.
Sintassi
HRESULT GetDisplayName(
[out] LPWSTR *pRetVal
);
Parametri
[out] pRetVal
Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di una stringa di caratteri wide con terminazione Null contenente il nome visualizzato. Il metodo alloca lo spazio di archiviazione per la stringa. Il chiamante è responsabile della liberazione dello spazio di archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.
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 parametro pRetVal è NULL. |
|
Memoria insufficiente. |
|
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
Se il client non ha chiamato IAudioSessionControl::SetDisplayName per impostare il nome visualizzato, la stringa sarà vuota. Anziché visualizzare una stringa di nome vuota, il programma Sndvol usa un nome predefinito, generato automaticamente per etichettare il controllo 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 |