Condividi tramite


funzione CM_Add_Res_Des (cfgmgr32.h)

La funzione CM_Add_Res_Des aggiunge un descrittore di risorse a una configurazione logica.

Sintassi

CMAPI CONFIGRET CM_Add_Res_Des(
  [out, optional] PRES_DES   prdResDes,
  [in]            LOG_CONF   lcLogConf,
  [in]            RESOURCEID ResourceID,
  [in]            PCVOID     ResourceData,
  [in]            ULONG      ResourceLen,
  [in]            ULONG      ulFlags
);

Parametri

[out, optional] prdResDes

Puntatore a una posizione per ricevere un handle per il nuovo descrittore di risorse.

[in] lcLogConf

Handle fornito dal chiamante alla configurazione logica a cui deve essere aggiunto il descrittore di risorse. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[in] ResourceID

Identificatore del tipo di risorsa fornito dal chiamante, che identifica il tipo di struttura fornito da ResourceData. Deve essere una delle costanti con prefisso ResType_ definite in Cfgmgr32.h.

[in] ResourceData

Puntatore fornito dal chiamante a una delle strutture di risorse elencate nella tabella seguente.

Resourceid Parametro Struttura delle risorse
ResType_BusNumber

BUSNUMBER_RESOURCE

ResType_ClassSpecific

CS_RESOURCE

ResType_DevicePrivate

DEVPRIVATE_RESOURCE

ResType_DMA

DMA_RESOURCE

ResType_IO

IO_RESOURCE

ResType_IRQ

IRQ_RESOURCE

ResType_Mem

MEM_RESOURCE

ResType_MfCardConfig

MFCARD_RESOURCE

ResType_PcCardConfig

PCCARD_RESOURCE

[in] ResourceLen

Lunghezza fornita dal chiamante della struttura a cui punta ResourceData.

[in] ulFlags

Non usato, deve essere zero.

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_Res_Des 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

I chiamanti di CM_Add_Res_Des devono chiamare CM_Free_Res_Des_Handle per deallocare l'handle del descrittore di risorse, dopo che non è più necessario.

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

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_Res_Des_Ex

CM_Free_Res_Des_Handle