Condividi tramite


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