Método IMFAsyncResult::GetObject (mfobjects.h)

Retorna um objeto associado à operação assíncrona. O tipo de objeto, se houver, depende do método assíncrono que foi chamado.

Sintaxe

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

Parâmetros

[out] ppObject

Recebe um ponteiro para a interface IUnknown do objeto. Se nenhum objeto estiver associado à operação, esse parâmetro receberá o valor NULL. Se o valor não for NULL, o chamador deverá liberar a interface .

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Não há nenhum objeto associado a esse resultado assíncrono.

Comentários

Normalmente, esse objeto é usado pelo componente que implementa o método assíncrono. Ele fornece uma maneira para a função que invoca o retorno de chamada para passar informações para o método End... assíncrono que conclui a operação.

Se você estiver implementando um método assíncrono, poderá definir o objeto por meio do parâmetro punkObject da função MFCreateAsyncResult .

Se o ponteiro IUnknown interno do objeto de resultado assíncrono for NULL, o método retornará E_POINTER.

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

• Windows XP com Service Pack 2 (SP2) e posterior.
• Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

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

Confira também

Métodos de retorno de chamada assíncronos

IMFAsyncResult