Compartilhar via


Interface IAMBufferNegotiation (strmif.h)

[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 IAMBufferNegotiation interface solicita o número de buffers para que um filtro crie e o tamanho de cada buffer. Essa interface pode ser exposta por qualquer pino que se conecta usando a interface de pino IMemInputPin , mas normalmente é exposta nos pinos de saída dos filtros de captura.

Quando dois pinos se conectam por meio de IMemInputPin, eles concordam com um objeto alocador responsável pela criação de buffers. Normalmente, esse processo é transparente para o aplicativo, mas em algumas situações o aplicativo precisa de mais controle. Se um pino expõe IAMBufferNegotiation, o aplicativo pode sugerir quantos buffers criar, o tamanho dos buffers e outras propriedades. Se o aplicativo executar a visualização do áudio capturado, você poderá especificar um tamanho de buffer menor para reduzir a latência. Os aplicativos de teleconferência devem especificar um número mínimo de buffers.

Para usar essa interface, chame o método SuggestAllocatorProperties antes que os pinos se conectem. Depois que os pinos se conectarem, chame o método GetAllocatorProperties para determinar se o pino a respeitou a solicitação.

Filtrar desenvolvedores: os filtros de captura sempre devem dar suporte a essa interface quando possível.

Herança

A interface IAMBufferNegotiation herda da interface IUnknown . IAMBufferNegotiation também tem estes tipos de membros:

Métodos

A interface IAMBufferNegotiation tem esses métodos.

 
IAMBufferNegotiation::GetAllocatorProperties

O método GetAllocatorProperties recupera as propriedades do alocador que o pin está usando.
IAMBufferNegotiation::SuggestAllocatorProperties

O método SuggestAllocatorProperties informa o pino das propriedades preferenciais do alocador do aplicativo. Chame esse método antes que o pin se conecte.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Interfaces