Função CM_Add_Res_Des (cfgmgr32.h)

  • Artigo

A função CM_Add_Res_Des adiciona um descritor de recurso a uma configuração lógica.

Sintaxe

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

Ponteiro para um local para receber um identificador para o novo descritor de recursos.

[in] lcLogConf

Identificador fornecido pelo chamador para a configuração lógica à qual o descritor de recursos deve ser adicionado. Esse identificador deve ter sido obtido anteriormente chamando uma das seguintes funções:

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 fornecido pelo chamador, que identifica o tipo de estrutura fornecido por ResourceData. Essa deve ser uma das constantes prefixadas ResType_ definidas em Cfgmgr32.h.

[in] ResourceData

Ponteiro fornecido pelo chamador para uma das estruturas de recursos listadas na tabela a seguir.

Resourceid Parâmetro Estrutura 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

Comprimento fornecido pelo chamador da estrutura apontada por ResourceData.

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Nota Começando com Windows 8, CM_Add_Res_Des retorna CR_CALL_NOT_IMPLEMENTED quando usado em um cenário Wow64. Para solicitar informações sobre os recursos de hardware em um computador local, é necessário implementar uma versão nativa da arquitetura do aplicativo usando as APIs de recurso de hardware. Por exemplo: um aplicativo AMD64 para sistemas AMD64.
 

Comentários

Os chamadores de CM_Add_Res_Des devem chamar CM_Free_Res_Des_Handle para desalocar o identificador do descritor de recursos, depois que ele não for mais necessário.

Os chamadores dessa função devem ter SeLoadDriverPrivilege. (Os privilégios são descritos na documentação do SDK do Microsoft Windows.)

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Add_Res_Des_Ex

CM_Free_Res_Des_Handle