Método IMFSimpleAudioVolume::SetMasterVolume (mfidl.h)

Define o nível de volume master.

Sintaxe

HRESULT SetMasterVolume(
  [in] float fLevel
);

Parâmetros

[in] fLevel

Nível de volume. O volume é expresso como um nível de atenuação, em que 0,0 indica silêncio e 1,0 indica volume completo (sem atenuação).

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
MF_E_NOT_INITIALIZED	O renderizador de áudio não é inicializado.
MF_E_STREAMSINK_REMOVED	O renderizador de áudio foi removido do pipeline.

Comentários

Eventos fora do aplicativo podem alterar o nível de volume master. Por exemplo, o usuário pode alterar o volume do programa de controle de volume do sistema (SndVol). Se um evento externo alterar o volume master, o renderizador de áudio enviará um evento MEAudioSessionVolumeChanged, que a Sessão de Mídia encaminha para o aplicativo.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfidl.h
Biblioteca	Mfuuid.lib

Confira também

IMFSimpleAudioVolume

Renderizador de Áudio de Streaming