Condividi tramite


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