Método IMemInputPin::GetAllocator (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 GetAllocator método recupera el asignador de memoria propuesto por este pin. Una vez seleccionado el asignador, este método devuelve un puntero al asignador seleccionado.
Sintaxis
HRESULT GetAllocator(
[out] IMemAllocator **ppAllocator
);
Parámetros
[out] ppAllocator
Recibe un puntero a la interfaz IMemAllocator del asignador. El autor de la llamada debe liberar la interfaz .
Valor devuelto
Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
No hay asignador disponible. |
Comentarios
Cuando un pin de salida se conecta a un pin de entrada, negocia con el pin de entrada para decidir sobre un asignador de memoria. El pin de salida llama a este método para recuperar el asignador propuesto del pin de entrada. Llama al método IMemInputPin::NotifyAllocator para especificar qué asignador seleccionó.
Si este método se realiza correctamente, la interfaz IMemAllocator tiene un recuento de referencias pendiente. Asegúrese de liberarlo cuando haya terminado.
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 |