Compartir a través de


comando MCI_GETDEVCAPS

El comando MCI_GETDEVCAPS recupera información estática sobre un dispositivo. Todos los dispositivos reconocen este comando. Los parámetros y marcas disponibles para este comando dependen del dispositivo seleccionado. La información se devuelve en el miembro dwReturn de la estructura identificada por lpCapsParms.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o, para dispositivos de vídeo digital y VCR, MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpCapsParms

Puntero a una estructura de MCI_GETDEVCAPS_PARMS .

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo contrario.

Comentarios

Las siguientes marcas estándar y específicas de comandos adicionales se aplican a todos los dispositivos que admiten MCI_GETDEVCAPS:

MCI_GETDEVCAPS_COMPOUND_DEVICE

El miembro dwReturn se establece en TRUE si el dispositivo usa el almacenamiento de datos que se debe abrir y cerrar explícitamente; se establece en FALSE de lo contrario.

MCI_GETDEVCAPS_DEVICE_TYPE

El miembro dwReturn se establece en uno de los valores enumerados en Tipos de dispositivo MCI.

MCI_GETDEVCAPS_HAS_AUDIO

El miembro dwReturn se establece en TRUE si el dispositivo tiene salida de audio; se establece en FALSE de lo contrario.

MCI_GETDEVCAPS_HAS_VIDEO

El miembro dwReturn se establece en TRUE si el dispositivo tiene salida de vídeo; se establece en FALSE de lo contrario. Por ejemplo, el miembro se establece en TRUE para los dispositivos que admiten el conjunto de comandos videodisc.

MCI_GETDEVCAPS_ITEM

Especifica que el miembro dwItem de la estructura MCI_GETDEVCAPS_PARMS contiene una de las siguientes constantes:

MCI_GETDEVCAPS_CAN_EJECT

El miembro dwReturn se establece en TRUE si el dispositivo puede expulsar el medio; de lo contrario, se establece en FALSE.

MCI_GETDEVCAPS_CAN_PLAY

El miembro dwReturn se establece en TRUE si el dispositivo puede reproducir el medio; de lo contrario, se establece en FALSE. Si un dispositivo especifica TRUE, implica que el dispositivo admite los comandos MCI_PAUSE y MCI_STOP , así como el comando MCI_PLAY .

MCI_GETDEVCAPS_CAN_RECORD

El miembro dwReturn se establece en TRUE si el dispositivo admite la grabación; de lo contrario, se establece en FALSE. Si un dispositivo especifica TRUE, implica que el dispositivo admite los comandos MCI_PAUSE y MCI_STOP, así como el comando MCI_RECORD .

MCI_GETDEVCAPS_CAN_SAVE

El miembro dwReturn se establece en TRUE si el dispositivo puede guardar un archivo; de lo contrario, se establece en FALSE.

MCI_GETDEVCAPS_USES_FILES

El miembro dwReturn se establece en TRUE si el dispositivo requiere un nombre de archivo; se establece en FALSE de lo contrario. Solo los dispositivos compuestos usan archivos.

Se pueden especificar las marcas siguientes en el miembro dwItem de MCI_GETDEVCAPS_PARMS para el tipo de dispositivo digitalvideo :

MCI_DGV_GETDEVCAPS_CAN_FREEZE

El miembro dwReturn se establece en TRUE si el dispositivo puede inmovilizar fotogramas; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_CAN_LOCK

El miembro dwReturn se establece en TRUE si el dispositivo puede bloquearse; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_CAN_REVERSE

El miembro dwReturn se establece en TRUE si el dispositivo puede reproducirse a la inversa; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_CAN_STR_IN

El miembro dwReturn se establece en TRUE si el dispositivo puede estirar la entrada; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_CAN_STRETCH

El miembro dwReturn se establece en TRUE si el dispositivo puede extender una imagen; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_CAN_TEST

El miembro dwReturn se establece en TRUE si el dispositivo puede realizar pruebas; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_HAS_STILL

El miembro dwReturn se establece en TRUE si el dispositivo puede mostrar imágenes fijas; de lo contrario, se establece en FALSE.

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

El miembro dwReturn se establece en el número máximo de ventanas que el dispositivo puede controlar simultáneamente.

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

El miembro dwReturn se establece en la velocidad de reproducción máxima del dispositivo, en fotogramas por segundo.

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

El miembro dwReturn se establece en la velocidad de reproducción mínima para el dispositivo, en fotogramas por segundo.

MCI_DGV_GETDEVCAPS_PALETTES

El miembro dwReturn se establece en TRUE si el dispositivo puede devolver un identificador de paleta; de lo contrario, se establece en FALSE.

Se pueden especificar las marcas siguientes en el miembro dwItem de MCI_GETDEVCAPS_PARMS para el tipo de dispositivo vcr :

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE

El miembro dwReturn se establece en el número de incrementos por segundo.

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de detectar la longitud del medio; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_FREEZE

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de congelar la imagen de salida; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de supervisar orígenes; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_PREROLL

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de inscribir previamente; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de obtener vistas previas; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_REVERSE

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de reproducirse a la inversa; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_CAN_TEST

El miembro dwReturn se establece en TRUE si el dispositivo es capaz de realizar pruebas; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_HAS_CLOCK

El miembro dwReturn se establece en TRUE si el dispositivo admite un reloj externo; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

El miembro dwReturn se establece en TRUE si el dispositivo tiene capacidad de código de tiempo o si esta funcionalidad es desconocida; de lo contrario, se establece en FALSE.

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

El miembro dwReturn se establece en el número de marcas (99).

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

El miembro dwReturn se establece en la precisión de búsqueda del dispositivo.

Se pueden especificar las marcas siguientes en el miembro dwItem de MCI_GETDEVCAPS_PARMS para el tipo de dispositivo de superposición :

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

El miembro dwReturn se establece en TRUE si el dispositivo puede inmovilizar la imagen; de lo contrario, se establece en FALSE.

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

El miembro dwReturn se establece en TRUE si el dispositivo puede estirar la imagen para rellenar el marco; de lo contrario, se establece en FALSE.

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

El miembro dwReturn se establece en el número máximo de ventanas que el dispositivo puede controlar simultáneamente.

Las marcas siguientes se pueden especificar en el miembro dwItem de MCI_GETDEVCAPS_PARMS para el tipo de dispositivo videodisc :

MCI_VD_GETDEVCAPS_CAN_REVERSE

El miembro dwReturn se establece en TRUE si el reproductor de videodisc puede reproducirse a la inversa; de lo contrario, se establece en FALSE. Algunos jugadores pueden reproducir discos CLV a la inversa, así como discos CAV.

MCI_VD_GETDEVCAPS_CAV

Cuando se combina con otros elementos, especifica que la información de devolución se aplica a videodiscs de formato CAV. Este es el valor predeterminado si no se inserta ningún videodisc.

MCI_VD_GETDEVCAPS_CLV

Cuando se combina con otros elementos, especifica que la información de devolución se aplica a videodiscs de formato CLV.

MCI_VD_GETDEVCAPS_FAST_RATE

El miembro dwReturn se establece en la velocidad de reproducción rápida estándar en fotogramas por segundo.

MCI_VD_GETDEVCAPS_NORMAL_RATE

El miembro dwReturn se establece en la velocidad de reproducción normal en fotogramas por segundo.

MCI_VD_GETDEVCAPS_SLOW_RATE

El miembro dwReturn se establece en la velocidad de reproducción lenta estándar en fotogramas por segundo.

Se pueden especificar las marcas siguientes en el miembro dwItem de MCI_GETDEVCAPS_PARMS para el tipo de dispositivo waveaudio :

MCI_WAVE_GETDEVCAPS_INPUT

El miembro dwReturn se establece en el número total de dispositivos de entrada de forma de onda (grabación).

MCI_WAVE_GETDEVCAPS_OUTPUT

El miembro dwReturn se establece en el número total de dispositivos de salida de forma de onda (reproducción).

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]
Encabezado
Mmsystem.h (incluye Windows.h)

Consulte también

MCI

Comandos de MCI