función CM_Add_Empty_Log_Conf (cfgmgr32.h)

Artículo
03/08/2023

La función CM_Add_Empty_Log_Conf crea una configuración lógica vacía, para un tipo de configuración especificado y una instancia de dispositivo especificada, en el equipo local.

Sintaxis

CMAPI CONFIGRET CM_Add_Empty_Log_Conf(
  [out] PLOG_CONF plcLogConf,
  [in]  DEVINST   dnDevInst,
  [in]  PRIORITY  Priority,
  [in]  ULONG     ulFlags
);

Parámetros

[out] plcLogConf

Dirección de una ubicación para recibir el identificador en una configuración lógica vacía.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] Priority

Valor de prioridad de configuración proporcionado por el autor de la llamada. Debe ser uno de los valores constantes enumerados en la tabla siguiente. Las constantes se muestran en orden de prioridad, de mayor a menor. (Para varias configuraciones con el mismo valor ulFlags , el sistema intentará usar primero el que tiene la prioridad más alta).

Constante priority	Definición
LCPRI_FORCECONFIG	Resultado de una configuración forzada.
LCPRI_BOOTCONFIG	Resultado de una configuración de arranque.
LCPRI_DESIRED	Configuración preferida (mejor rendimiento).
LCPRI_NORMAL	Configuración de trabajo (rendimiento aceptable).
LCPRI_LASTBESTCONFIG	Solo para uso interno.
LCPRI_SUBOPTIMAL	No es una configuración deseable, pero funcionará.
LCPRI_LASTSOFTCONFIG	Solo para uso interno.
LCPRI_RESTART	El sistema debe reiniciarse.
LCPRI_REBOOT	El sistema debe reiniciarse (igual que LCPRI_RESTART).
LCPRI_POWEROFF	El sistema debe apagarse y apagarse.
LCPRI_HARDRECONFIG	Se debe cambiar un jumper.
LCPRI_HARDWIRED	No se puede cambiar la configuración.
LCPRI_IMPOSSIBLE	La configuración no puede existir.
LCPRI_DISABLED	Configuración deshabilitada.

[in] ulFlags

Marcas proporcionadas por el autor de la llamada que especifican el tipo de la configuración lógica. Se debe especificar una de las marcas siguientes.

Marcas de tipo de configuración	Definiciones
BASIC_LOG_CONF	Los descriptores de recursos agregados a esta configuración describirán una configuración básica.
FILTERED_LOG_CONF	No debe usarse. (Solo el administrador de PnP puede crear una configuración filtrada).
ALLOC_LOG_CONF	No debe usarse. (Solo el administrador de PnP puede crear una configuración asignada).
BOOT_LOG_CONF	Los descriptores de recursos agregados a esta configuración describirán una configuración de arranque.
FORCED_LOG_CONF	Los descriptores de recursos agregados a esta configuración describirán una configuración forzada.
OVERRIDE_LOG_CONF	Los descriptores de recursos agregados a esta configuración describen una configuración de invalidación.

Una de las marcas de bits siguientes puede ser ORed con la marca de tipo de configuración.

Marcas de comparación de prioridad	Definiciones
PRIORITY_EQUAL_FIRST	Si varias configuraciones del mismo tipo (ulFlags) tienen la misma prioridad (Prioridad), esta configuración se coloca al principio de la lista.
PRIORITY_EQUAL_LAST	(Valor predeterminado) Si varias configuraciones del mismo tipo (ulFlags) tienen la misma prioridad (Prioridad), esta configuración se coloca al final de la lista.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Add_Empty_Log_Conf devuelve CR_CALL_NOT_IMPLEMENTED cuando se usa en un escenario wow64. Para solicitar información sobre los recursos de hardware en un equipo local, es necesario implementar una versión nativa de arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.

Comentarios

Llamar a CM_Add_Empty_Log_Conf puede hacer que los identificadores devueltos por CM_Get_First_Log_Conf y CM_Get_Next_Log_Conf no sean válidos. Por lo tanto, si desea obtener configuraciones lógicas después de llamar a CM_Add_Empty_Log_Conf, el código debe llamar de nuevo a CM_Get_First_Log_Conf y empezar en la primera configuración.

Para quitar una configuración lógica creada por CM_Add_Empty_Log_Conf, llame a CM_Free_Log_Conf.

El identificador recibido en plcLogConf debe liberarse explícitamente llamando a CM_Free_Log_Conf_Handle.

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados al equipo local, consulte CM_Get_Child.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib
Archivo DLL	Cfgmgr32.dll