Função MFCreateSampleGrabberSinkActivate (mfidl.h)

Artigo
03/05/2025

Cria um objeto de ativação para o coletor de mídia de captura de exemplo.

Sintaxe

HRESULT MFCreateSampleGrabberSinkActivate(
  IMFMediaType                 *pIMFMediaType,
  IMFSampleGrabberSinkCallback *pIMFSampleGrabberSinkCallback,
  IMFActivate                  **ppIActivate
);

Parâmetros

pIMFMediaType

Ponteiro para a interface IMFMediaType, definindo o tipo de mídia para o fluxo de entrada do capturador de exemplo.

pIMFSampleGrabberSinkCallback

Ponteiro para a interface IMFSampleGrabberSinkCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface.

ppIActivate

Recebe um ponteiro para a interface IMFActivate. Use essa interface para concluir a criação do seletor de exemplo. O chamador deve liberar a interface.

Valor de retorno

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Para criar o coletor de captura de exemplo, chame IMFActivate::ActivateObject no ponteiro recebido no parâmetro ppIActivate.

Antes de chamar ActivateObject, você pode configurar o seletor de exemplo definindo qualquer um dos seguintes atributos no ponteiro ppIActivate:

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	mfidl.h
biblioteca	Mf.lib
de DLL	Mf.dll

Consulte também

Funções do Media Foundation

Compartilhar via