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 |