Função CM_Get_Resource_Conflict_DetailsW (cfgmgr32.h)

  • Artigo

A função CM_Get_Resource_Conflict_Details obtém os detalhes sobre um dos conflitos de recursos em uma lista de conflitos.

Sintaxe

CMAPI CONFIGRET CM_Get_Resource_Conflict_DetailsW(
  [in]      CONFLICT_LIST       clConflictList,
  [in]      ULONG               ulIndex,
  [in, out] PCONFLICT_DETAILS_W pConflictDetails
);

Parâmetros

[in] clConflictList

Identificador fornecido pelo chamador para uma lista de conflitos, obtido por uma chamada anterior para CM_Query_Resource_Conflict_List.

[in] ulIndex

Valor fornecido pelo chamador usado como um índice na lista de conflitos. Esse valor pode ser de zero a um a menos do que o número retornado por CM_Get_Resource_Conflict_Count.

[in, out] pConflictDetails

Endereço fornecido pelo chamador de uma estrutura CONFLICT_DETAILS para receber detalhes de conflito. O chamador deve fornecer valores para as estruturas CD_ulSize e CD_ulMask da estrutura.

Valor retornado

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.

Comentários

Para determinar os requisitos de recursos conflitantes entre um dispositivo especificado e outros dispositivos em um computador, use as etapas a seguir.

  1. Chame CM_Query_Resource_Conflict_List para obter um identificador para uma lista de conflitos de recursos.
  2. Chame CM_Get_Resource_Conflict_Count para determinar o número de conflitos contidos na lista de conflitos de recursos.
  3. Chame CM_Get_Resource_Conflict_Details para cada entrada na lista de conflitos.
Os seguintes conflitos normalmente não são relatados:
  • Se houver vários conflitos para um recurso e os proprietários de apenas alguns dos conflitos puderem ser determinados, os conflitos sem proprietários identificáveis não serão relatados.
  • Conflitos que parecem ser com o dispositivo especificado (ou seja, o dispositivo entra em conflito consigo mesmo) não são relatados.
  • Se vários dispositivos não Plug and Play usarem o mesmo driver, os conflitos de recursos entre esses dispositivos poderão não ser relatados.
Às vezes, os recursos atribuídos ao HAL podem ser relatados como conflitantes com o HAL ou não disponíveis.

Requisitos

   
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