Compartilhar via


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:

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