Método IAudioSessionControl::GetIconPath (audiopolicy.h)
O método GetIconPath recupera o caminho do ícone de exibição da sessão de áudio.
Sintaxe
HRESULT GetIconPath(
[out] LPWSTR *pRetVal
);
Parâmetros
[out] pRetVal
Ponteiro para uma variável de ponteiro na qual o método grava o endereço de uma cadeia de caracteres largos terminada em nulo que especifica o caminho totalmente qualificado de um arquivo .ico, .dll ou .exe que contém o ícone. O método aloca o armazenamento para a cadeia de caracteres. O chamador é responsável por liberar o armazenamento, quando ele não é mais necessário, chamando a função CoTaskMemFree . Para obter informações sobre caminhos de ícone e CoTaskMemFree, consulte a documentação do SDK do Windows.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O parâmetro pRetVal é NULL. |
|
Sem memória. |
|
O dispositivo de ponto de extremidade de áudio foi desconectado ou o hardware de áudio ou os recursos de hardware associados foram reconfigurados, desabilitados, removidos ou não estão disponíveis para uso. |
|
O serviço de áudio do Windows não está em execução. |
Comentários
Se um cliente não tiver chamado IAudioSessionControl::SetIconPath para definir o ícone de exibição, a cadeia de caracteres estará vazia. Se nenhum ícone especificado pelo cliente estiver disponível, o programa Sndvol usará o ícone da janela de aplicativo do cliente para rotular o controle de volume para a sessão de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | audiopolicy.h |