Condividi tramite


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:

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