Método IAMExtTransport::GetCapability (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 GetCapability método recupera las funcionalidades generales del transporte.

Sintaxis

HRESULT GetCapability(
  [in]  long   Capability,
  [out] long   *pValue,
  [out] double *pdblValue
);

Parámetros

[in] Capability

Especifica la funcionalidad que se va a comprobar. Vea Comentarios para obtener más información.

[out] pValue

Puntero a una variable que recibe un entero largo . Vea Comentarios para obtener más información.

[out] pdblValue

Puntero a una variable que recibe un doble. Vea Comentarios para obtener más información.

Valor devuelto

Cuando este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El parámetro Capability es una marca que especifica qué capacidad comprobar. El método devuelve el resultado en el parámetro pValue o en el parámetro pdblValue , según la marca de funcionalidad.

Para las marcas siguientes, el método devuelve el valor OATRUE o OAFALSE en el parámetro pValue . El valor OATRUE indica que la funcionalidad está presente, mientras que el valor OAFALSE indica que está ausente.

Marca de funcionalidad	Descripción
ED_TRANSCAP_CAN_ASSEMBLE	El transporte puede usar el modo de registro ensamblado (grabar pistas nuevas que se vinculan sin problemas a la pista de control del segmento grabado previamente).
ED_TRANSCAP_CAN_BUMP_PLAY	El transporte puede sincronizarse con una velocidad variable.
ED_TRANSCAP_CAN_DELAY_AUDIO_IN	El transporte puede realizar ediciones de audio retrasadas.
ED_TRANSCAP_CAN_DELAY_AUDIO_OUT	El transporte puede realizar ediciones de audio retrasadas.
ED_TRANSCAP_CAN_DELAY_VIDEO_IN	El transporte puede realizar ediciones de vídeo retrasadas.
ED_TRANSCAP_CAN_DELAY_VIDEO_OUT	El transporte puede realizar ediciones de vídeo retrasadas.
ED_TRANSCAP_CAN_DETECT_LENGTH	El transporte puede detectar la longitud del medio.
ED_TRANSCAP_CAN_EJECT	El transporte puede expulsar los medios.
ED_TRANSCAP_CAN_FREEZE	El transporte puede inmovilizar o pausar.
ED_TRANSCAP_CAN_INSERT	El transporte puede usar el modo de registro de inserción (grabar pistas individuales mientras están bloqueados en una pista de control precordada).
ED_TRANSCAP_CAN_PLAY_BACKWARDS	El transporte puede jugar hacia atrás.
ED_TRANSCAP_CAN_SET_EE	El transporte puede mostrar la entrada del dispositivo en su salida.
ED_TRANSCAP_CAN_SET_PB	El transporte puede mostrar la reproducción multimedia en su salida.
ED_TRANSCAP_FIELD_STEP	El transporte responde a un comando de avance de fotogramas avanzando un campo.
ED_TRANSCAP_HAS_CLOCK	El dispositivo tiene un reloj.
ED_TRANSCAP_HAS_DT	El dispositivo tiene un seguimiento dinámico.
ED_TRANSCAP_HAS_TIMER	El dispositivo tiene un temporizador.
ED_TRANSCAP_HAS_TUNER	El dispositivo tiene un tóner.
ED_TRANSCAP_IS_MASTER	El dispositivo es el reloj maestro para la sincronización.
ED_TRANSCAP_MULTIPLE_EDITS	El dispositivo admite varios eventos de edición.
ED_TRANSCAP_NEEDS_CUEING	El dispositivo se debe cued antes de realizar una edición.
ED_TRANSCAP_NEEDS_TBC	El dispositivo debe calibrarse.

 

Para las marcas siguientes, el método devuelve un valor numérico en el parámetro pValue .

Marca de funcionalidad	Valor devuelto
ED_TRANSCAP_LTC_TRACK	Devuelve el número de seguimiento de la pista de código de tiempo LTC o ED_ALL si no hay ninguna pista de código de tiempo dedicado.
ED_TRANSCAP_NUM_AUDIO_TRACKS	Devuelve el número de pistas de audio.

 

Para las marcas siguientes, el método devuelve un valor en el parámetro pdblValue .

Marca de funcionalidad	Valor devuelto
ED_TRANSCAP_FWD_SHUTTLE_MAX	Velocidad de avance máxima en modo de lanzadera, como un múltiplo de velocidad de juego.
ED_TRANSCAP_FWD_SHUTTLE_MIN	Velocidad de avance mínima en modo de lanzadera, como un múltiplo de velocidad de juego.
ED_TRANSCAP_FWD_VARIABLE_MAX	Velocidad de avance máxima, como múltiplo de velocidad de juego.
ED_TRANSCAP_FWD_VARIABLE_MIN	Velocidad de avance mínima, como múltiplo de velocidad de juego.
ED_TRANSCAP_REV_SHUTTLE_MAX	Velocidad inversa máxima en modo de lanzadera, como múltiplo de velocidad de juego.
ED_TRANSCAP_REV_SHUTTLE_MIN	Velocidad inversa mínima en modo de lanzadera, como un múltiplo de velocidad de juego.
ED_TRANSCAP_REV_VARIABLE_MAX	Velocidad inversa máxima, como múltiplo de velocidad de juego.
ED_TRANSCAP_REV_VARIABLE_MIN	Velocidad inversa mínima, como múltiplo de velocidad de juego.

 

Implementación de DV

MSDV no admite este método. Devuelve E_NOTIMPL.

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 (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IAMExtTransport (interfaz)