Método IMFActivate::ActivateObject (mfobjects.h)

Cria o objeto associado a esse objeto de ativação.

Sintaxe

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[in] riid

IID (identificador de interface) da interface solicitada.

[out] ppv

Recebe um ponteiro para a interface solicitada. O chamador deve liberar a interface .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Alguns objetos do Microsoft Media Foundation devem ser desligados antes de serem liberados. Nesse caso, o chamador é responsável por desligar o objeto retornado em ppv. Para desligar o objeto, siga um destes procedimentos:

• Chamar IMFActivate::ShutdownObject no objeto de ativação ou
• Chame o método de desligamento específico do objeto. Esse método dependerá do tipo de objeto . Algumas possibilidades incluem:
  • Fontes de mídia: chame IMFMediaSource::Shutdown.
  • Coletores de mídia: chame IMFMediaSink::Shutdown.
  • Qualquer objeto que dê suporte à interface IMFShutdown : chame IMFShutdown::Shutdown.

O método IMFActivate::ShutdownObject é genérico para todos os tipos de objeto. Se o objeto não exigir um método de desligamento, ShutdownObject terá êxito e não terá efeito. Se você não souber o método de desligamento específico do objeto (ou não souber o tipo de objeto), chame IMFActivate::ShutdownObject.

Após a primeira chamada para ActivateObject, as chamadas subsequentes retornam um ponteiro para a mesma instância, até que o cliente chame ShutdownObject ou IMFActivate::D etachObject.

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	mfobjects.h
Biblioteca	Mfuuid.lib

Confira também

Objetos de ativação

IMFActivate