Método IAMStreamConfig::GetNumberOfCapabilities (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 GetNumberOfCapabilities
método recupera el número de funcionalidades de formato que admite este pin.
Sintaxis
HRESULT GetNumberOfCapabilities(
[out] int *piCount,
[out] int *piSize
);
Parámetros
[out] piCount
Puntero a una variable que recibe el número de funcionalidades de formato.
[out] piSize
Puntero a una variable que recibe el tamaño de la estructura de configuración en bytes. Vea Comentarios para obtener más información.
Valor devuelto
Devuelve un valor HRESULT . Estos son algunos de los valores posibles.
Código devuelto | Descripción |
---|---|
|
Correcto. |
|
Valor de puntero NULL. |
|
El pin de entrada no está conectado. |
Observaciones
Un pin de salida puede admitir más de un conjunto de funcionalidades de formato. Este método devuelve el número total de funcionalidades que admite el pin; el número se devuelve en el parámetro piCount . Para recuperar un conjunto determinado de funcionalidades, llame al método IAMStreamConfig::GetStreamCaps . Las funcionalidades de formato se indexan desde cero, por lo que el valor devuelto en piCount es uno más que el límite superior.
Dependiendo del tipo de formato del pin, la estructura de VIDEO_STREAM_CONFIG_CAPS (para vídeo) o una estructura de AUDIO_STREAM_CONFIG_CAPS (para audio). El parámetro piSize recibe el tamaño de la estructura, en bytes.
En algunos filtros de compresión, este método produce un error si el pin de entrada del filtro no está conectado.
Requisitos
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 |