Método IAudioSessionControl::GetIconPath (audiopolicy.h)
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 |
|---|---|
|
El parámetro pRetVal es NULL. |
|
Memoria insuficiente |
|
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. |
|
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 |