Função CM_Query_Resource_Conflict_List (cfgmgr32.h)

  • Artigo

A função CM_Query_Resource_Conflict_List identifica instâncias de dispositivo com requisitos de recurso que entram em conflito com a descrição de recursos de uma instância de dispositivo especificada.

Sintaxe

CMAPI CONFIGRET CM_Query_Resource_Conflict_List(
  [out]          PCONFLICT_LIST pclConflictList,
  [in]           DEVINST        dnDevInst,
  [in]           RESOURCEID     ResourceID,
  [in]           PCVOID         ResourceData,
  [in]           ULONG          ResourceLen,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

Parâmetros

[out] pclConflictList

Endereço fornecido pelo chamador de um local para receber um identificador para uma lista de conflitos.

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao identificador de computador fornecido por hMachine.

[in] ResourceID

Identificador de tipo de recurso fornecido pelo chamador. Essa deve ser uma das constantes prefixadas ResType_ definidas em Cfgmgr32.h.

[in] ResourceData

Ponteiro fornecido pelo chamador para um descritor de recurso, que pode ser uma das estruturas listadas na descrição da função CM_Add_Res_Des de ResourceData.

[in] ResourceLen

Comprimento fornecido pelo chamador da estrutura apontada por ResourceData.

[in] ulFlags

Não usado, deve ser zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.

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

Ao chamar CM_Query_Resource_Conflict_List, especifique um identificador de instância de dispositivo e um descritor de recursos. (Os descritores de recursos para nós de dispositivo existentes podem ser obtidos chamando CM_Get_Res_Des_Data.) Esses parâmetros indicam os recursos específicos que você deseja que um dispositivo específico use. A lista de conflitos resultante identifica os dispositivos que usam os mesmos recursos, juntamente com os recursos reservados pelo computador.

Depois de chamar CM_Query_Resource_Conflict_List, um aplicativo pode chamar CM_Get_Resource_Conflict_Count para determinar o número de conflitos contidos na lista de conflitos de recursos. (O número de conflitos pode ser zero.) Em seguida, o aplicativo pode chamar CM_Get_Resource_Conflict_Details para cada entrada na lista de conflitos.

Depois que um aplicativo terminar de usar o identificador recebido para pclConflictList, ele deverá chamar CM_Free_Resource_Conflict_Handle.

Para obter informações sobre como usar identificadores de instância de dispositivo associados a um computador local ou remoto, consulte CM_Get_Child_Ex.

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_Free_Resource_Conflict_Handle

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details