Compartilhar via


Método CTransInPlaceInputPin.NotifyAllocator

[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.]

O NotifyAllocator método especifica um alocador para a conexão. Esse método implementa o método IMemInputPin::NotifyAllocator .

Sintaxe

HRESULT NotifyAllocator(
   IMemAllocator *pAllocator,
   BOOL          bReadOnly
);

Parâmetros

pAllocator

Ponteiro para a interface IMemAllocator do alocador.

bReadOnly

Sinalizador que especifica se os exemplos desse alocador são somente leitura. Se TRUE, os exemplos serão somente leitura.

Retornar valor

Retorna um valor HRESULT . Os valores possíveis incluem os mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
Êxito
E_FAIL
Falha
E_POINTER
Argumento de ponteiro NULL

Comentários

O filtro tenta usar o mesmo alocador para ambas as conexões de pino.

  • Se o pino de saída não estiver conectado, o pin de entrada aceitará automaticamente o alocador. Quando o pino de saída estiver conectado, o filtro reconectará o pino de entrada. Nesse ponto, o filtro tentará novamente usar um único alocador.
  • Se o pino de saída estiver conectado, o pin de entrada aceitará o alocador. O pino de saída também usa o mesmo alocador. Ele chama NotifyAllocator no pino de entrada downstream.

O caso anterior tem a seguinte exceção:

  • Se o alocador proposto for somente leitura (ou seja, o parâmetro bReadOnly for TRUE) e o filtro precisar modificar os exemplos, o filtro deverá usar dois alocadores diferentes. Nesse caso, se o filtro upstream estiver propondo usar o alocador do filtro downstream, o método retornará E_FAIL.

Requisitos

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

Confira também

Classe CTransInPlaceInputPin