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, 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 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 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_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 multipista que pueden grabar en pistas seleccionadas. |
| ED_DEVCAP_CAN_SAVE | El dispositivo puede guardar datos. |
| ED_DEVCAP_CTLTRK_READ | El dispositivo puede leer las 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 calibrar. 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 el código de tiempo de 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 cinta de audio |
| ED_DEVTYPE_CG | Generador de caracteres |
| ED_DEVTYPE_DDR | Grabadora de disco digital |
| 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/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
Los controladores 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. En la siguiente tabla se muestran los valores posibles. 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 capacidades 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 | 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 (incluya Dshow.h) |
| Library | Strmiids.lib |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de