comando MCI_INFO
El comando MCI_INFO recupera información de cadena de un dispositivo. Todos los dispositivos reconocen este comando. La información se devuelve en el miembro lpstrReturn de la estructura identificada por lpInfo. El miembro dwRetSize especifica la longitud del búfer para los datos devueltos.
Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_INFO,
DWORD dwFlags,
(DWORD) (LPMCI_INFO_PARMS) lpInfo
);
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.
-
lpInfo
-
Puntero a una estructura de MCI_INFO_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).
Valor devuelto
Devuelve cero si es correcto o si se produce un error de lo contrario.
Comentarios
La siguiente marca estándar y específica de comandos adicional se aplica a todos los dispositivos que admiten MCI_INFO:
-
MCI_INFO_PRODUCT
-
Obtiene una descripción del hardware asociado a un dispositivo. Los dispositivos deben proporcionar una descripción que identifique tanto el controlador como el hardware usado.
Las siguientes marcas adicionales se aplican al tipo de dispositivo cdaudio :
-
MCI_INFO_MEDIA_IDENTITY
-
Genera un identificador único para el CD de audio cargado actualmente en el reproductor que se está consultando. Esta marca devuelve una cadena de 16 dígitos hexadecimales.
-
MCI_INFO_MEDIA_UPC
-
Genera el código de producto universal (UPC) que se codifica en un CD de audio. La UB es una cadena de dígitos. Es posible que no esté disponible para todos los CD.
Las siguientes marcas adicionales se aplican al tipo de dispositivo digitalvideo :
-
MCI_DGV_INFO_ITEM
-
Constante que indica la información deseada se incluye en el miembro dwItem de la estructura identificada por lpInfo. Las siguientes constantes se definen para dispositivos de vídeo digital:
-
MCI_DGV_INFO_AUDIO_ALG
-
Devuelve el nombre del algoritmo de compresión de audio actual.
-
MCI_DGV_INFO_AUDIO_QUALITY
-
Devuelve el nombre del descriptor de calidad de audio actual.
-
MCI_DGV_INFO_STILL_ALG
-
Devuelve el nombre del algoritmo de compresión de imagen todavía actual.
-
MCI_DGV_INFO_STILL_QUALITY
-
Devuelve el nombre del descriptor de calidad de imagen todavía actual.
-
MCI_DGV_INFO_USAGE
-
Devuelve una cadena que describe las restricciones de uso que puede imponer el propietario de los datos visuales o audibles del área de trabajo.
-
MCI_DGV_INFO_VIDEO_ALG
-
Devuelve el nombre del algoritmo de compresión de vídeo actual.
-
MCI_DGV_INFO_VIDEO_QUALITY
-
Devuelve el nombre del descriptor de calidad de vídeo actual.
-
MCI_INFO_VERSION
-
Devuelve el nivel de versión del controlador de dispositivo y el hardware. Los desarrolladores de controladores de dispositivos deben documentar la sintaxis de la cadena devuelta.
-
MCI_DGV_INFO_TEXT
-
Obtiene la ventana subtítulo.
-
MCI_INFO_FILE
-
Obtiene la ruta de acceso y el nombre de archivo del último archivo especificado con el comando MCI_OPEN o MCI_LOAD . Si no se ha especificado un archivo, el dispositivo devuelve una cadena terminada en null. Esta marca solo es compatible con los dispositivos que devuelven TRUE a la marca MCI_GETDEVCAPS_USES_FILES del comando MCI_GETDEVCAPS .
En el caso de los dispositivos de vídeo digital, lpInfo apunta a una estructura de MCI_DGV_INFO_PARMS .
Las siguientes marcas adicionales se aplican al tipo de dispositivo secuenciador :
-
MCI_INFO_COPYRIGHT
-
Obtiene el aviso de copyright del archivo MIDI del meta evento copyright.
-
MCI_INFO_FILE
-
Obtiene el nombre de archivo del archivo actual. Esta marca solo es compatible con los dispositivos que devuelven TRUE cuando se llama al comando MCI_GETDEVCAPS con la marca MCI_GETDEVCAPS_USES_FILES.
-
MCI_INFO_NAME
-
Obtiene el nombre de secuencia del evento meta sequence/track name.
La siguiente marca adicional se aplica al tipo de dispositivo vcr :
-
MCI_VCR_INFO_VERSION
-
Establece el miembro lpstrReturn de la estructura MCI_INFO_PARMS para que apunte al número de versión. También establece el miembro dwRetSize igual a la longitud de la cadena a la que apunta.
Las siguientes marcas adicionales se aplican al tipo de dispositivo de superposición :
-
MCI_INFO_FILE
-
Obtiene el nombre de archivo del archivo actual. Esta marca solo es compatible con los dispositivos que devuelven TRUE a la marca MCI_GETDEVCAPS_USES_FILES del comando MCI_GETDEVCAPS .
-
MCI_OVLY_INFO_TEXT
-
Obtiene el subtítulo de la ventana asociada al dispositivo de superposición de vídeo.
Las siguientes marcas adicionales se aplican al tipo de dispositivo waveaudio :
-
MCI_INFO_FILE
-
Obtiene el nombre de archivo del archivo actual. Esta marca es compatible con los dispositivos que devuelven TRUE cuando se llama al comando MCI_GETDEVCAPS con la marca MCI_GETDEVCAPS_USES_FILES.
-
MCI_WAVE_INPUT
-
Obtiene el nombre del producto de la entrada actual.
-
MCI_WAVE_OUTPUT
-
Obtiene el nombre del producto de la salida actual y su valor es específico del dispositivo.
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 |
|