Método IMFMediaEventQueue::QueueEventParamVar (mfobjects.h)

Cria um evento, define um PROPVARIANT como os dados do evento e coloca o evento na fila.

Chame esse método dentro de sua implementação de IMFMediaEventGenerator::QueueEvent. Passe os parâmetros desse método diretamente para esse método.

Você também pode chamar esse método quando o componente precisar gerar um evento que não contenha atributos. Se os dados do evento forem um ponteiro IUnknown , você poderá usar IMFMediaEventQueue::QueueEventParamUnk. Se o evento contiver atributos, use IMFMediaEventQueue::QueueEvent .

Sintaxe

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

Parâmetros

[in] met

Especifica o tipo do evento a ser adicionado à fila. O tipo de evento é retornado pelo método IMFMediaEvent::GetType do evento. Para obter uma lista de tipos de eventos, consulte Media Foundation Events.

[in] guidExtendedType

O tipo estendido do evento. Se o evento não tiver um tipo estendido, use o valor GUID_NULL. O tipo estendido é retornado pelo método IMFMediaEvent::GetExtendedType do evento.

[in] hrStatus

Um código de êxito ou falha que indica o status do evento. Esse valor é retornado pelo método IMFMediaEvent::GetStatus do evento.

[in] pvValue

Ponteiro para um PROPVARIANT que contém o valor do evento. Este parâmetro pode ser NULL. Esse valor é retornado pelo método IMFMediaEvent::GetValue do evento.

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.
MF_E_SHUTDOWN	O método Shutdown foi chamado.

Comentários

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

IMFMediaEventQueue