Método CMediaEvent.Invoke

Artigo
07/28/2023

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Fornece acesso a propriedades e métodos expostos por um objeto.

Sintaxe

HRESULT Invoke(
   DISPID     dispidMember,
   REFIID     riid,
   LCID       lcid,
   WORD       wFlags,
   DISPPARAMS *pdispparams,
   VARIANT    *pvarResult,
   EXCEPINFO  *pexcepinfo,
   UINT       *puArgErr
);

Parâmetros

dispidMember: Identificador do membro. Use CMediaEvent::GetIDsOfNames ou a documentação do objeto para obter o identificador de expedição.
riid: Reservado para uso futuro. Deve ser IID_NULL.
lcid: Contexto de localidade no qual interpretar argumentos.
wFlags: Sinalizadores que descrevem o contexto da CMediaEvent::Invoke chamada.
Pdispparams: Ponteiro para uma estrutura que contém uma matriz de argumentos, uma matriz de IDs de expedição de argumento para argumentos nomeados e contagens para o número de elementos nas matrizes.
Pvarresult: Ponteiro para onde o resultado deve ser armazenado ou NULL se o chamador não espera nenhum resultado.
pexcepinfo: Ponteiro para uma estrutura que contém informações de exceção.
Puargerr: Ponteiro para o índice do primeiro argumento, dentro da matriz rgvarg da estrutura DISPPARAMS, que tem um erro. Para obter mais informações sobre DISPPARAMS, consulte o SDK da plataforma.

Retornar valor

Retornará DISP_E_UNKNOWNINTERFACE se riid não estiver IID_NULL. Retorna um dos códigos de erro de CMediaEvent::GetTypeInfo se a chamada falhar. Caso contrário, retorna o HRESULT da chamada para IDispatch::Invoke.

Requisitos

Requisito	Valor
parâmetro	Ctlutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CMediaEvent

Partilhar via