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

Consulte también

MCI

Comandos de MCI