Compartilhar via

Função CreatePosPassThru

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

A CreatePosPassThru função cria um objeto CPosPassThru ou um objeto CRendererPosPassThru .

Sintaxe

STDAPI CreatePosPassThru(
   LPUNKNOWN pAgg,
   BOOL      bRenderer,
   IPin      *pPin,
   IUnknown  **ppPassThru
);

Parâmetros

pAgg

Ponteiro para o proprietário deste objeto. Se o objeto for agregado, passe um ponteiro para a interface IUnknown do objeto de agregação. Caso contrário, defina esse parâmetro como NULL.

bRenderer

Valor booliano que especifica se o filtro é um renderizador. Use o valor TRUE se o filtro for um renderizador ou FALSE caso contrário. Se o valor for TRUE, esse método criará uma instância da classe CRendererPosPassThru . Se o valor for FALSE, o método criará uma instância da classe CPosPassThru .

pPin

Ponteiro para a interface IPin no pino de entrada do filtro.

ppPassThru

Endereço de uma variável que recebe um ponteiro para a interface IUnknown do objeto.

Retornar valor

Retorna S_OK se tiver êxito. Caso contrário, retorna um valor HRESULT que indica a causa do erro.

Comentários

Esse método usa a interface ISeekingPassThru para criar o objeto . O objeto é carregado dinamicamente de Quartz.dll.

Se a função for bem-sucedida, a interface IUnknown retornada terá uma contagem de referência pendente. O chamador deve liberar a interface .

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 CPosPassThru