Método IPin::QueryAccept (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 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 |
|---|---|
|
El pin rechaza el tipo de medio. |
|
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 |