función CM_Add_Res_Des (cfgmgr32.h)

  • Artículo

La función CM_Add_Res_Des agrega un descriptor de recursos a una configuración lógica.

Sintaxis

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
);

Parámetros

[out, optional] prdResDes

Puntero a una ubicación para recibir un identificador al nuevo descriptor de recursos.

[in] lcLogConf

Identificador proporcionado por el autor de la llamada a la configuración lógica a la que se debe agregar el descriptor de recursos. Este identificador debe haberse obtenido previamente llamando a una de las siguientes funciones:

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

Identificador de tipo de recurso proporcionado por el autor de la llamada, que identifica el tipo de estructura proporcionado por ResourceData. Debe ser una de las constantes con prefijo ResType_ definidas en Cfgmgr32.h.

[in] ResourceData

Puntero proporcionado por el autor de la llamada a una de las estructuras de recursos enumeradas en la tabla siguiente.

ResourceID Parámetro Estructura de recursos
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

Longitud proporcionada por el autor de la llamada de la estructura a la que apunta ResourceData.

[in] ulFlags

No se usa, debe ser cero.

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

Los autores de llamadas de CM_Add_Res_Des deben llamar a CM_Free_Res_Des_Handle para desasignar el identificador del descriptor de recursos, después de que ya no sea necesario.

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

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

Consulte también

CM_Add_Res_Des_Ex

CM_Free_Res_Des_Handle