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

Retorna o objeto de estado especificado pelo chamador no método Begin assíncrono.

Sintaxe

HRESULT GetState(
  [out] IUnknown **ppunkState
);

Parâmetros

[out] ppunkState

Recebe um ponteiro para a interface IUnknown do objeto de estado. 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 de estado associado a esse resultado assíncrono.

Comentários

O chamador do método assíncrono especifica o objeto de estado e pode usá-lo para qualquer finalidade definida pelo chamador. O objeto de estado pode ser NULL. Se o objeto de estado for NULL, GetState retornará E_POINTER.

Se você estiver implementando um método assíncrono, defina o objeto state no por meio do parâmetro punkState da função MFCreateAsyncResult .

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