Método IRenderEngine::GetGroupOutputPin
[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.
Nota:
[Desusado. Esta API se puede quitar de futuras versiones de Windows.
El GetGroupOutputPin método recupera el pin de salida del grupo especificado.
Sintaxis
HRESULT GetGroupOutputPin(
long Group,
[out] IPin **ppRenderPin
);
Parámetros
-
Grupo
-
Índice de base cero que especifica el grupo.
-
ppRenderPin [out]
-
Recibe un puntero a la interfaz IPin del pin de salida.
Valor devuelto
Devuelve un valor HRESULT . Entre los valores posibles figuran los siguientes:
| Código devuelto | Descripción |
|---|---|
|
El grupo no tiene un pin de salida. |
|
Correcto. |
|
Argumento no válido. |
|
No se pudo inicializar el motor de representación. |
|
Puntero no válido. |
|
Error en la operación porque el proyecto no se ha representado correctamente. |
|
error inesperado. |
Observaciones
Antes de llamar a este método, llame a IRenderEngine::ConnectFrontEnd para compilar el front-end del grafo. Cada grupo representa una única secuencia multimedia y el front-end tiene un pin de salida correspondiente.
Puede usar este método para crear la parte de representación de un gráfico de escritura de archivos. Conecte las patillas de salida a filtros de multiplexador y filtros de escritor de archivos. Para obtener más información, vea Representación de un proyecto.
Para obtener una vista previa, no es necesario llamar a este método. Simplemente llame a ConnectFrontEnd seguido de IRenderEngine::RenderOutputPins.
Si el método devuelve S_OK, la interfaz IPin que devuelve tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarlo.
Nota:
El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.
Nota:
Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también