Método ISampleGrabber::GetConnectedMediaType

[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 GetConnectedMediaType método recupera el tipo de medio para la conexión en el pin de entrada del captador de muestra.

Sintaxis

HRESULT GetConnectedMediaType(
   AM_MEDIA_TYPE *pType
);

Parámetros

pType

Puntero a una estructura AM_MEDIA_TYPE asignada por el autor de la llamada.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_POINTER	Argumento de puntero NULL.
S_OK	Correcto.
VFW_E_NOT_CONNECTED	El filtro no está conectado.

 

Observaciones

Este método copia el tipo de medio en la estructura AM_MEDIA_TYPE especificada por pType. El autor de la llamada debe liberar el bloque de formato del tipo de medio. Puede usar la función CoTaskMemFree o la función FreeMediaType en la biblioteca de clases base.

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	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

Usar el captador de ejemplo

ISampleGrabber (interfaz)