Interfaz IAMBufferNegotiation (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La IAMBufferNegotiation interfaz solicita el número de búferes para que un filtro cree y tamaño de cada búfer. Esta interfaz se puede exponer mediante cualquier patilla que se conecte mediante la interfaz de patillas IMemInputPin , pero normalmente se expone en los pines de salida de los filtros de captura.

Cuando dos patillas se conectan a través de IMemInputPin, aceptan un objeto de asignador responsable de crear búferes. Normalmente, este proceso es transparente para la aplicación, pero en algunas situaciones la aplicación necesita más control. Si un pin expone IAMBufferNegotiation, la aplicación puede sugerir el número de búferes que se van a crear, el tamaño de los búferes y otras propiedades. Si la aplicación realiza una vista previa del audio capturado, puede especificar un tamaño de búfer más pequeño para reducir la latencia. Las aplicaciones de teleconferencia deben especificar un número mínimo de búferes.

Para usar esta interfaz, llame al método SuggestAllocatorProperties antes de que se conecten los patillas. Después de conectar los pines, llame al método GetAllocatorProperties para determinar si la patilla respeta la solicitud.

Programadores de filtros: los filtros de captura siempre deben admitir esta interfaz siempre que sea posible.

Herencia

La interfaz IAMBufferNegotiation hereda de la interfaz IUnknown . IAMBufferNegotiation también tiene estos tipos de miembros:

Métodos

La interfaz IAMBufferNegotiation tiene estos métodos.

IAMBufferNegotiation::GetAllocatorProperties El método GetAllocatorProperties recupera las propiedades de asignador que usa el pin.
IAMBufferNegotiation::SuggestAllocatorProperties El método SuggestAllocatorProperties informa al pin de las propiedades de asignador preferidas de la aplicación. Llame a este método antes de que se conecte el pin.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)

Consulte también

Interfaces