Negociação de alocadores

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize 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.]

Quando dois pinos se conectam, eles precisam de um mecanismo para trocar dados de mídia. Esse mecanismo é chamado de de transporte. Em geral, a arquitetura do DirectShow é neutra em relação aos transportes. Dois filtros podem concordar em se conectar usando qualquer transporte suportado por ambos.

O transporte mais comum é o de memória local transporte, no qual os dados de mídia residem na memória principal. Existem dois tipos de transporte de memória local, o modelo push e o modelo pull. No modelo push, o filtro de origem envia dados para o filtro downstream, usando a interface IMemInputPin no pino de entrada do filtro downstream. No modelo pull, o filtro downstream solicita dados do filtro de origem, usando o interface IAsyncReader no pino de saída do filtro de origem. Para obter mais informações sobre esses dois modelos de fluxo de dados, consulte Fluxo de dados no Gráfico de filtro.

No transporte de memória local, o objeto responsável pela alocação de buffers de memória é chamado de alocador de . Um alocador suporta a interfaceIMemAllocator. Ambos os pinos compartilham um único alocador. Qualquer pino pode fornecer um alocador, mas o pino de saída seleciona qual alocador usar.

O pino de saída também define as propriedades do alocador, que determinam quantos buffers são criados pelo alocador, o tamanho de cada buffer e o alinhamento da memória. O pino de saída pode adiar para o pino de entrada para os requisitos de buffer.

Em uma conexão de IMemInputPin, a negociação do alocador funciona da seguinte maneira:

1. Opcionalmente, o pino de saída chama IMemInputPin::GetAllocatorRequirements. Esse método recupera os requisitos de buffer do pino de entrada, como alinhamento de memória. Em geral, o pino de saída deve honrar a solicitação do pino de entrada, a menos que haja uma boa razão para não fazê-lo.
2. Opcionalmente, o pino de saída chama IMemInputPin::GetAllocator. Este método solicita um alocador do pino de entrada. O pino de entrada fornece um ou retorna um código de erro.
3. O pino de saída seleciona um alocador. Ele pode usar um fornecido pelo pino de entrada, ou criar o seu próprio.
4. O pino de saída chama IMemAllocator::SetProperties para definir as propriedades do alocador. No entanto, o alocador pode não honrar as propriedades solicitadas. (Por exemplo, isso pode acontecer se o pino de entrada fornecer o alocador.) O alocador retorna as propriedades reais como um parâmetro de saída no método SetProperties.
5. O outpin chama IMemInputPin::NotifyAllocator para informar o pino de entrada da seleção.
6. O pino de entrada deve chamar IMemAllocator::GetProperties para verificar se as propriedades do alocador são aceitáveis.
7. O pino de saída é responsável por comprometer e desautorizar o alocador. Isso ocorre quando o streaming é iniciado e interrompido.

Em uma conexão IAsyncReader, a negociação do alocador funciona da seguinte maneira:

1. O pino de entrada chama IAsyncReader::RequestAllocator no pino de saída. O pino de entrada especifica seus requisitos de buffer e, opcionalmente, fornece um alocador.
2. O pino de saída seleciona um alocador. Ele pode usar o fornecido pelo pino de entrada, se houver, ou criar o seu próprio.
3. O pino de saída retorna o alocador como um parâmetro de saída no método RequestAllocator. O pino de entrada deve verificar as propriedades do alocador.
4. O pino de entrada é responsável por cometer e desautorizar o alocador.
5. A qualquer momento durante o processo de negociação do alocador, qualquer pino pode falhar na conexão.
6. Se o pino de saída usar o alocador do pino de entrada, ele poderá usar esse alocador apenas para entregar amostras para esse pino de entrada. O filtro proprietário não deve utilizar o alocador para entregar amostras a outros pinos.

Tópicos relacionados

Fornecendo um alocador personalizado