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

Crea el objeto asociado a este objeto de activación.

Sintaxis

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

Parámetros

[in] riid

Identificador de interfaz (IID) de la interfaz solicitada.

[out] ppv

Recibe un puntero a la interfaz solicitada. El autor de la llamada debe liberar la interfaz .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Algunos objetos de Microsoft Media Foundation deben apagarse antes de liberarse. Si es así, el autor de la llamada es responsable de apagar el objeto que se devuelve en ppv. Para apagar el objeto, realice una de las acciones siguientes:

• Llame a IMFActivate::ShutdownObject en el objeto de activación o
• Llame al método de apagado específico del objeto. Este método dependerá del tipo de objeto. Entre las posibilidades se incluyen:
  • Orígenes multimedia: llame a IMFMediaSource::Shutdown.
  • Receptores de medios: llame a IMFMediaSink::Shutdown.
  • Cualquier objeto que admita la interfaz IMFShutdown : Llame a IMFShutdown::Shutdown.

El método IMFActivate::ShutdownObject es genérico para todos los tipos de objetos. Si el objeto no requiere un método de apagado, ShutdownObject se realiza correctamente y no tiene ningún efecto. Si no conoce el método de apagado específico del objeto (o no conoce el tipo de objeto), llame a IMFActivate::ShutdownObject.

Después de la primera llamada a ActivateObject, las llamadas posteriores devuelven un puntero a la misma instancia, hasta que el cliente llama a ShutdownObject o IMFActivate::D etachObject.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfobjects.h
Library	Mfuuid.lib

Consulte también

Objetos de activación

IMFActivate