Compartilhar via

Negociando alocadores

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture 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 Audio/Video Capture 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 que ambos dão suporte.

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

No transporte de memória local, o objeto responsável por alocar buffers de memória é chamado de do alocador de. Um alocador dá suporte à interface deIMemAllocator. Ambos os pinos compartilham um único alocador. Qualquer um dos pinos 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 de memória. O pino de saída pode adiar para o pin de entrada para os requisitos de buffer.

Em uma conexão 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 o alinhamento de memória. Em geral, o pino de saída deve respeitar a solicitação do pino de entrada, a menos que haja um bom motivo para não fazer isso.
  2. Opcionalmente, o pino de saída chama IMemInputPin::GetAllocator. Esse 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 pin de entrada ou criar 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. As chamadas de outpin IMemInputPin::NotifyAllocator para informar o pin 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 confirmar e descompactar 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. As chamadas de pino de entrada 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 aquele fornecido pelo pino de entrada, se houver, ou criar 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 pin de entrada é responsável por confirmar e descompactar o alocador.
  5. A qualquer momento durante o processo de negociação do alocador, qualquer um dos pinos 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 fornecer amostras para esse pino de entrada. O filtro proprietário não deve usar o alocador para entregar amostras a outros pinos.

fornecendo um alocador personalizado

 

 

  • Last updated on