Compartilhar via


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

Recupera o nível de volume master.

Sintaxe

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Parâmetros

[out] pfLevel

Recebe o 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

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