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.

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

Consulte también

Códigos de error y éxito

IMemInputPin (interfaz)