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

Vedi anche

Interfaccia IAudioSessionControl

IAudioSessionControl::SetIconPath