comando info

Artículo
06/13/2023

El comando info recupera una descripción de hardware de un dispositivo. Todos los dispositivos MCI reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
);

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszInfoType

Marca que identifica el tipo de información necesaria. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando de información y las marcas usadas por cada tipo.

Valor	Significado	Significado
cdaudio	info identityinfo upc	product
digitalvideo	algoritmo de audioaudio qualityfileproductstill algorithmstill qualitystill quality	usageversionvideo algorithmvideovideo qualitywindow text
overlay	fileproduct	texto de la ventana
sequencer	copyrightfile	nameproduct
Vcr	product	version
videodisk	product
waveaudio	fileinput	outputproduct

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszInfoType y sus significados.

Valor	Significado
algoritmo de audio	Devuelve el nombre del algoritmo de compresión de audio actual.
calidad de audio	Devuelve el nombre del descriptor de calidad de audio actual. Esto podría devolver "desconocido" si la aplicación ha establecido parámetros en valores específicos que no corresponden a cualidades definidas.
copyright	Recupera el aviso de copyright del archivo MIDI del metaevento copyright.
archivo	Recupera el nombre del archivo utilizado por el dispositivo compuesto. Si el dispositivo se abre sin un archivo y no se ha usado el comando load , se devuelve una cadena nula.
identidad de información	Genera un identificador único para el CD de audio cargado actualmente en el reproductor que se está consultando.
info 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.
input	Recupera la descripción del dispositivo de entrada actual. Devuelve "none" si no se establece un dispositivo de entrada.
name	Recupera el nombre de secuencia del evento meta sequence/track name.
output	Recupera la descripción del dispositivo de salida actual. Devuelve "none" si no se establece un dispositivo de salida.
product	Recupera una descripción del dispositivo. Esta información suele incluir el nombre del producto y el modelo. La longitud de la cadena tendrá 31 caracteres o menos.
algoritmo still	Devuelve el nombre del algoritmo de compresión de imágenes todavía actual.
calidad fija	Devuelve el nombre del descriptor de calidad de imagen todavía actual. Esto podría devolver "desconocido" si la aplicación ha establecido parámetros en valores específicos que no corresponden a cualidades definidas.
usage	Devuelve una cadena que describe las restricciones de uso que el propietario de los datos visuales o de audio pueden imponer en el área de trabajo.
version	Devuelve el nivel de versión del controlador de dispositivo y el hardware.
algoritmo de vídeo	Devuelve el nombre del algoritmo de compresión de vídeo actual.
calidad de vídeo	Devuelve el nombre del descriptor de calidad de vídeo actual. Esto podría devolver "desconocido" si la aplicación ha establecido parámetros en valores específicos que no corresponden a cualidades definidas.
texto de la ventana	Recupera el subtítulo de la ventana usada por el dispositivo.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "test". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

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

Ejemplos

El siguiente comando recupera una descripción del hardware asociado al dispositivo "mysound".

info mysound product

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]

Consulte también

MCI
Cadenas de comandos de MCI
carga