Metodo IMFActivate::ActivateObject (mfobjects.h)

Crea l'oggetto associato a questo oggetto di attivazione.

Sintassi

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

Parametri

[in] riid

Identificatore di interfaccia (IID) dell'interfaccia richiesta.

[out] ppv

Riceve un puntatore all'interfaccia richiesta. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Alcuni oggetti di Microsoft Media Foundation devono essere arrestati prima del rilascio. In tal caso, il chiamante è responsabile dell'arresto dell'oggetto restituito in ppv. Per arrestare l'oggetto, eseguire una delle operazioni seguenti:

• Chiamare IMFActivate::ShutdownObject sull'oggetto di attivazione o
• Chiamare il metodo di arresto specifico dell'oggetto. Questo metodo dipenderà dal tipo di oggetto. Le possibilità includono:
  • Origini multimediali: chiama IMFMediaSource::Shutdown.
  • Sink multimediali: chiamare IMFMediaSink::Shutdown.
  • Qualsiasi oggetto che supporta l'interfaccia IMFShutdown : Chiama IMFShutdown::Shutdown.

Il metodo IMFActivate::ShutdownObject è generico per tutti i tipi di oggetto. Se l'oggetto non richiede un metodo di arresto, ShutdownObject ha esito positivo e non ha alcun effetto. Se non si conosce il metodo di arresto specifico per l'oggetto (o non si conosce il tipo di oggetto), chiamare IMFActivate::ShutdownObject.

Dopo la prima chiamata a ActivateObject, le chiamate successive restituiscono un puntatore alla stessa istanza finché il client chiama ShutdownObject o IMFActivate::D etachObject.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h
Libreria	Mfuuid.lib

Vedi anche

Oggetti attivazione

IMFActivate