Método IAMExtDevice::GetCapability (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEnginey captura de audio y 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 captura de audio y vídeo 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 método GetCapability recupera las funciones del dispositivo externo.

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 de 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.

Observaciones

El parámetro Capability es una marca que especifica qué capacidad se va a 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_DEVCAP_AUDIO_INPUTS	El dispositivo acepta la entrada de audio.
ED_DEVCAP_CAN_MONITOR_SOURCES	El dispositivo puede enviar cualquier entrada a la salida supervisada, independientemente de la entrada seleccionada actualmente.
ED_DEVCAP_CAN_PREVIEW	El dispositivo puede obtener una vista previa.
ED_DEVCAP_CAN_RECORD	El dispositivo puede grabar.
ED_DEVCAP_CAN_RECORD_STROBE	El dispositivo puede grabar estroboso. Esta funcionalidad se aplica a dispositivos multitrack que pueden grabar en pistas seleccionadas.
ED_DEVCAP_CAN_SAVE	El dispositivo puede guardar datos.
ED_DEVCAP_CTLTRK_READ	El dispositivo puede leer pistas de control.
ED_DEVCAP_HAS_AUDIO	El dispositivo tiene audio.
ED_DEVCAP_HAS_VIDEO	El dispositivo tiene vídeo.
ED_DEVCAP_INDEX_READ	El dispositivo puede leer marcas de índice.
ED_DEVCAP_NEEDS_CALIBRATING	El dispositivo necesita calibración. Consulte IAMExtDevice::Calibrate.
ED_DEVCAP_TIMECODE_READ	El dispositivo puede leer el código de tiempo de SMPTE.
ED_DEVCAP_TIMECODE_WRITE	El dispositivo puede establecer código de tiempo SMPTE.
ED_DEVCAP_USES_FILES	El dispositivo tiene un sistema de archivos integrado.
ED_DEVCAP_VIDEO_INPUTS	El dispositivo acepta la entrada de vídeo.

 

Para las marcas siguientes, el método devuelve una constante definida en el parámetro pValue.

ED_DEVCAP_DEVICE_TYPE: devuelve el tipo de dispositivo.

Constante devuelta	Descripción
ED_DEVTYPE_ATR	Grabadora de cintas de audio
ED_DEVTYPE_CG	Generador de caracteres
ED_DEVTYPE_DDR	Grabadora de discos digitales
ED_DEVTYPE_DVE	Unidad de efectos de vídeo digital
ED_DEVTYPE_GPI	Desencadenador de interfaz de uso general
ED_DEVTYPE_KEYER	Keyer de vídeo
ED_DEVTYPE_LASERDISK	Laserdisc
ED_DEVTYPE_MIXER_AUDIO	Mezclador de audio
ED_DEVTYPE_MIXER_VIDEO	Mezclador de vídeo
ED_DEVTYPE_ROUTER	Enrutador de vídeo
ED_DEVTYPE_TBC	Corrector de base de tiempo
ED_DEVTYPE_TCG	Generador o lector de código de tiempo
ED_DEVTYPE_VCR	VCR o videocámara con capacidades completas de VCR
ED_DEVTYPE_WIPEGEN	Generador de borrado de vídeo
ED_DEVTYPE_JOYSTICK	Joystick
ED_DEVTYPE_KEYBOARD	Teclado

 

ED_DEVCAP_SYNC_ACCURACY: devuelve una indicación de la precisión de sincronización del dispositivo.

Constante devuelta	Descripción
ED_SYNCACC_PRECISE	El dispositivo tiene precisión precisa.
ED_SYNCACC_FRAME	El dispositivo es preciso en el marco.
ED_SYNCACC_ROUGH	El dispositivo es menor que la precisión del marco.

 

ED_DEVCAP_NORMAL_RATE: devuelve la velocidad de fotogramas normal del dispositivo.

Constante devuelta	Descripción
ED_RATE_24	24 fotogramas por segundo (fps)
ED_RATE_25	25 fps
ED_RATE_2997	29,97 fps
ED_RATE_30	30 fps

 

ED_DEVCAP_SEEK_TYPE: devuelve una indicación de la precisión de búsqueda del dispositivo.

Constante devuelta	Descripción
ED_SEEK_PERFECT	El dispositivo puede buscar dentro de un fotograma de vídeo sin una interrupción de señal.
ED_SEEK_FAST	El dispositivo puede buscar rápidamente, con una breve interrupción en la señal.
ED_SEEK_SLOW	El dispositivo busca lentamente; como el transporte de cintas.

 

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

Marca de funcionalidad	Valor devuelto
ED_DEVCAP_EXTERNAL_DEVICE_ID	Identificador específico del fabricante.
ED_DEVCAP_PREROLL	Tiempo de inscripción previa del dispositivo.
ED_DEVCAP_POSTROLL	Tiempo de inscripción del dispositivo.

 

En Windows XP Service Pack 2 y versiones posteriores, se admiten las siguientes marcas adicionales para ED_DEVCAP_DEVICE_TYPE.

Constante devuelta	Descripción
ED_DEVTYPE_CAMERA_STORAGE	Almacenamiento para imágenes fijas o archivos de vídeo cortos.
ED_DEVTYPE_DTV	Televisión digital con interfaz de bus serie.
ED_DEVTYPE_PC_VIRTUAL	Dispositivo virtual o emulado en un equipo.

 

Para usar estas constantes, incluya el archivo de encabezado Xprtdefs.h.

implementación de DV de

Los controladores de MSDV y UVC admiten los siguientes comportamientos.

La marca ED_DEVCAP_NORMAL_RATE devuelve la velocidad de fotogramas.

Constante devuelta	Descripción
ED_RATE_25	25 fps (velocidad de fotogramas PAL predeterminada)
ED_RATE_2997	29,997 fps (velocidad de fotogramas NTSC predeterminada)

 

Solo para MSDV, la marca ED_DEVCAP_DEVICE_TYPE devuelve el tipo de dispositivo. Los valores posibles se muestran en la tabla siguiente. En el caso de los dispositivos UVC, use la interfaz IKsTopologyInfo en su lugar.

Constante devuelta	Descripción
ED_DEVTYPE_CAMERA	Cámara sencilla que puede grabar o pausar, pero carece de funcionalidades completas de VCR.
ED_DEVTYPE_DVHS	El dispositivo admite el formato D-VHS.
ED_DEVTYPE_UNKNOWN	Tipo de dispositivo desconocido.
ED_DEVTYPE_VCR	El dispositivo tiene funcionalidades completas de VCR.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	strmif.h (include Dshow.h)
biblioteca de	Strmiids.lib

Consulte también

códigos de error y correcto

de interfaz IAMExtDevice