Metodo IMFAsyncResult::GetObject (mfobjects.h)

Restituisce un oggetto associato all'operazione asincrona. Il tipo di oggetto, se presente, dipende dal metodo asincrono chiamato.

Sintassi

HRESULT GetObject(
  [out] IUnknown **ppObject
);

Parametri

[out] ppObject

Riceve un puntatore all'interfaccia IUnknown dell'oggetto. Se all'operazione non è associato alcun oggetto, questo parametro riceve il valore NULL. Se il valore non è NULL, il chiamante deve rilasciare l'interfaccia.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Non esiste alcun oggetto associato a questo risultato asincrono.

Commenti

In genere, questo oggetto viene usato dal componente che implementa il metodo asincrono. Fornisce un modo per la funzione che richiama il callback per passare le informazioni al metodo End asincrono che completa l'operazione.

Se si implementa un metodo asincrono, è possibile impostare l'oggetto tramite il parametro punkObject della funzione MFCreateAsyncResult .

Se il puntatore IUnknown interno dell'oggetto risultato asincrono è NULL, il metodo restituisce E_POINTER.

Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

• Windows XP con Service Pack 2 (SP2) e versioni successive.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

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 (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

Metodi di callback asincroni

IMFAsyncResult