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
S_OK
Correcto.
E_POINTER
Valor de puntero NULL.
VFW_E_NOT_CONNECTED
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

Consulte también

Códigos de error y éxito

Interfaz IAMStreamConfig