comando MCI_SYSINFO
El comando MCI_SYSINFO recupera información sobre los dispositivos MCI. MCI admite este comando directamente en lugar de pasarlo al dispositivo. Cualquier aplicación de MCI puede usar este comando. La información de cadena se devuelve en el búfer proporcionado por la aplicación a la que apunta el miembro lpstrReturn de la estructura identificada por lpSysInfo. La información numérica se devuelve como un valor DWORD colocado en el búfer proporcionado por la aplicación. El miembro dwRetSize especifica la longitud del búfer.
Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
Parámetros
-
wDeviceID
-
Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.
-
dwFlags
-
Una o varias de las siguientes marcas estándar y específicas de comandos:
-
MCI_SYSINFO_INSTALLNAME
-
Obtiene el nombre (enumerado en el registro o en el archivo SYSTEM.INI) que se usa para instalar el dispositivo.
-
MCI_SYSINFO_NAME
-
Obtiene un nombre de dispositivo correspondiente al número de dispositivo especificado en el miembro dwNumber de la estructura identificada porlpSysInfo. Si se establece la marca MCI_SYSINFO_OPEN, MCI devuelve los nombres de los dispositivos abiertos.
-
MCI_SYSINFO_OPEN
-
Obtiene la cantidad o el nombre de los dispositivos abiertos.
-
MCI_SYSINFO_QUANTITY
-
Obtiene el número de dispositivos del tipo especificado que se enumeran en el Registro o en la sección [mci] del archivo SYSTEM.INI. Si se establece la marca MCI_SYSINFO_OPEN, se devuelve el número de dispositivos abiertos.
-
lpSysInfo
-
Puntero a una estructura de MCI_SYSINFO_PARMS .
Valor devuelto
Devuelve cero si es correcto o si se produce un error en caso contrario.
Comentarios
El miembro wDeviceType de la estructura identificada por lpSysInfo se usa para indicar el tipo de dispositivo de la consulta. Si el parámetro wDeviceID se establece en MCI_ALL_DEVICE_ID, invalida el valor de wDeviceType. Para obtener una lista de los tipos de dispositivo, consulte Tipos de dispositivo MCI.
Los valores devueltos enteros son valores DWORD devueltos en el búfer al que apunta el miembro lpstrReturn de la estructura identificada por lpSysInfo.
Los valores devueltos de cadena son cadenas terminadas en null que se devuelven en el búfer al que apunta el miembro lpstrReturn de la estructura identificada por lpSysInfo.
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 |
|