Condividi tramite


funzione CM_Add_Empty_Log_Conf (cfgmgr32.h)

La funzione CM_Add_Empty_Log_Conf crea una configurazione logica vuota, per un tipo di configurazione specificato e un'istanza del dispositivo specificata, nel computer locale.

Sintassi

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

Parametri

[out] plcLogConf

Indirizzo di una posizione per ricevere l'handle a una configurazione logica vuota.

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.

[in] Priority

Valore di priorità di configurazione fornito dal chiamante. Deve essere uno dei valori costanti elencati nella tabella seguente. Le costanti sono elencate in ordine di priorità, dal più alto al più basso. Per più configurazioni con lo stesso valore ulFlags , il sistema tenterà di usare quello con la priorità più alta per primo.

Costante Priority Definizione
LCPRI_FORCECONFIG Risultato di una configurazione forzata.
LCPRI_BOOTCONFIG Risultato di una configurazione di avvio.
LCPRI_DESIRED Configurazione preferita (prestazioni migliori).
LCPRI_NORMAL Configurazione utilizzabile (prestazioni accettabili).
LCPRI_LASTBESTCONFIG Solo per uso interno.
LCPRI_SUBOPTIMAL Non è una configurazione auspicabile, ma funzionerà.
LCPRI_LASTSOFTCONFIG Solo per uso interno.
LCPRI_RESTART Il sistema deve essere riavviato
LCPRI_REBOOT Il sistema deve essere riavviato (come LCPRI_RESTART).
LCPRI_POWEROFF Il sistema deve essere arrestato e spento.
LCPRI_HARDRECONFIG È necessario modificare un jumper.
LCPRI_HARDWIRED Non è possibile modificare la configurazione.
LCPRI_IMPOSSIBLE La configurazione non può esistere.
LCPRI_DISABLED Configurazione disabilitata.

[in] ulFlags

Flag forniti dal chiamante che specificano il tipo di configurazione logica. È necessario specificare uno dei flag seguenti.

Flag del tipo di configurazione Definizioni
BASIC_LOG_CONF I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di base.
FILTERED_LOG_CONF Non usare. Solo il gestore PnP può creare una configurazione filtrata.
ALLOC_LOG_CONF Non usare. Solo il gestore PnP può creare una configurazione allocata.
BOOT_LOG_CONF I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di avvio.
FORCED_LOG_CONF I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione forzata.
OVERRIDE_LOG_CONF I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di override.
 

Uno dei flag di bit seguenti può essere ORed con il flag del tipo di configurazione.

Flag di confronto priorità Definizioni
PRIORITY_EQUAL_FIRST Se più configurazioni dello stesso tipo (ulFlags) hanno la stessa priorità (Priorità), questa configurazione viene posizionata all'inizio dell'elenco.
PRIORITY_EQUAL_LAST (Impostazione predefinita) Se più configurazioni dello stesso tipo (ulFlags) hanno la stessa priorità (Priorità), questa configurazione viene posizionata nella parte finale dell'elenco.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Nota A partire da Windows 8, CM_Add_Empty_Log_Conf restituisce CR_CALL_NOT_IMPLEMENTED se usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.
 

Commenti

La chiamata CM_Add_Empty_Log_Conf può causare l'invalidità degli handle restituiti da CM_Get_First_Log_Conf e CM_Get_Next_Log_Conf . Pertanto, se si desidera ottenere configurazioni logiche dopo aver chiamato CM_Add_Empty_Log_Conf, il codice deve chiamare di nuovo CM_Get_First_Log_Conf e iniziare alla prima configurazione.

Per rimuovere una configurazione logica creata da CM_Add_Empty_Log_Conf, chiamare CM_Free_Log_Conf.

La maniglia ricevuta in plcLogConf deve essere liberata esplicitamente chiamando CM_Free_Log_Conf_Handle.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Per informazioni sull'uso di handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib
DLL Cfgmgr32.dll

Vedi anche

CM_Add_Empty_Log_Conf_Ex

CM_Free_Log_Conf

CM_Free_Log_Conf_Handle

CM_Get_Child

CM_Get_First_Log_Conf

CM_Get_Next_Log_Conf