Compartir a través de

Método IAudioSessionControl::GetIconPath (audiopolicy.h)

  • Artículo

El método GetIconPath recupera la ruta de acceso del icono de presentación de la sesión de audio.

Sintaxis

HRESULT GetIconPath(
  [out] LPWSTR *pRetVal
);

Parámetros

[out] pRetVal

Puntero a una variable de puntero en la que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que especifica la ruta de acceso completa de un archivo de .ico, .dll o .exe que contiene el icono. El método asigna el almacenamiento para la cadena. El autor de la llamada es responsable de liberar el almacenamiento, cuando ya no es necesario, llamando a la función CoTaskMemFree . Para obtener información sobre las rutas de acceso de icono y CoTaskMemFree, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 El parámetro pRetVal es NULL.
E_OUTOFMEMORY
 Memoria insuficiente
AUDCLNT_E_DEVICE_INVALIDATED
 El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o no están disponibles para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
 El servicio de audio de Windows no se está ejecutando.

Comentarios

Si un cliente no ha llamado a IAudioSessionControl::SetIconPath para establecer el icono de presentación, la cadena estará vacía. Si no hay ningún icono especificado por el cliente disponible, el programa Sndvol usa el icono de la ventana de la aplicación del cliente para etiquetar el control de volumen de la sesión de audio.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado audiopolicy.h

Consulte también

IAudioSessionControl (interfaz)

IAudioSessionControl::SetIconPath