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
E_POINTER	Il parametro pRetVal è NULL.
E_OUTOFMEMORY	Memoria insufficiente.
AUDCLNT_E_DEVICE_INVALIDATED	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.
AUDCLNT_E_SERVICE_NOT_RUNNING	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

Vedi anche

Interfaccia IAudioSessionControl

IAudioSessionControl::SetDisplayName