Método IMemAllocatorCallbackTemp::SetNotify (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.
El SetNotify método establece o quita una devolución de llamada en el asignador. El asignador llama al método de devolución de llamada cada vez que se llama al método IMemAllocator::ReleaseBuffer del asignador.
Sintaxis
HRESULT SetNotify(
IMemAllocatorNotifyCallbackTemp *pNotify
);
Parámetros
pNotify
Puntero a la interfaz IMemAllocatorNotifyCallbackTemp que se usará para la devolución de llamada. El llamador debe implementar la interfaz . Use el valor NULL para quitar la devolución de llamada.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o un código de error de lo contrario.
Comentarios
Cada vez que se llama al método ReleaseBuffer del asignador, el asignador llama al método NotifyRelease en la interfaz proporcionada en pNotify. El método ReleaseBuffer devuelve un ejemplo multimedia a la lista gratuita del asignador. Los ejemplos llaman a este método cuando sus recuentos de referencias alcanzan cero.
El asignador contiene un recuento de referencias en la interfaz IMemAllocatorNotifyCallbackTemp del autor de la llamada. Esto puede crear recuentos de referencia circulares, lo que impide que los objetos del grafo se liberen correctamente. Por lo tanto, cuando el llamador ya no necesita notificaciones de devolución de llamada, debe llamar a este método de nuevo con el valor NULL. Un momento adecuado para hacerlo es cuando el gráfico se detiene o, de lo contrario, cuando se desconectan las patillas.
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 (incluya Dshow.h) |
| Library | Strmiids.lib |