Compartir a través de


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

Consulte también

MCI

Comandos MCI