Método IPin::QueryAccept (strmif.h)

  • Artículo

[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 QueryAccept método determina si el pin acepta un tipo de medio especificado.

Sintaxis

HRESULT QueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

Parámetros

[in] pmt

Puntero a una estructura AM_MEDIA_TYPE que especifica el tipo de medio.

Valor devuelto

Devuelve uno de los valores siguientes:

Código devuelto Descripción
S_FALSE
 El pin rechaza el tipo de medio.
S_OK
 El pin acepta el tipo de medio.

Comentarios

Un valor devuelto de S_OK indica que el pin aceptará el tipo de medio, ya sea en el ejemplo siguiente o después de una reconexión de patillas. La implementación debe tener en cuenta el estado actual del filtro, incluidas las conexiones en otros pines, y las propiedades que se pueden establecer en el filtro.

Cualquier otro valor devuelto, incluido S_FALSE, significa que el pin rechaza el tipo de medio. Por lo tanto, prueba para S_OK explícitamente; no use la macro SUCCEEDED .

Si el filtro se está ejecutando, un valor devuelto de S_OK es ambiguo. El pin puede aceptar un cambio de formato en el siguiente ejemplo multimedia, sin volver a conectarse; o es posible que tenga que volver a conectarse. Si el pin admite la interfaz IPinConnection , llame al método IPinConnection::D ynamicQueryAccept , que comprueba específicamente si el pin puede aceptar el nuevo tipo sin volver a conectarse.

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

Consulte también

Data Flow en el gráfico de filtros

Cambios de formato dinámico

Códigos de error y éxito

IPin (interfaz)