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