fonction CM_Get_Resource_Conflict_DetailsA (cfgmgr32.h)

Article
08/22/2023

La fonction CM_Get_Resource_Conflict_Details obtient les détails sur l’un des conflits de ressources d’une liste de conflits.

Syntaxe

CMAPI CONFIGRET CM_Get_Resource_Conflict_DetailsA(
  [in]      CONFLICT_LIST       clConflictList,
  [in]      ULONG               ulIndex,
  [in, out] PCONFLICT_DETAILS_A pConflictDetails
);

Paramètres

[in] clConflictList

Handle fourni par l’appelant à une liste de conflits, obtenu par un appel précédent à CM_Query_Resource_Conflict_List.

[in] ulIndex

Valeur fournie par l’appelant utilisée comme index dans la liste des conflits. Cette valeur peut être comprise entre zéro et un de moins que le nombre retourné par CM_Get_Resource_Conflict_Count.

[in, out] pConflictDetails

Adresse fournie par l’appelant d’une structure de CONFLICT_DETAILS pour recevoir les détails du conflit. L’appelant doit fournir des valeurs pour les structures CD_ulSize et CD_ulMask de la structure.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Remarques

Pour déterminer les besoins en ressources en conflit entre un appareil spécifié et d’autres appareils sur un ordinateur, procédez comme suit.

Appelez CM_Query_Resource_Conflict_List pour obtenir un handle pour une liste de conflits de ressources.
Appelez CM_Get_Resource_Conflict_Count pour déterminer le nombre de conflits contenus dans la liste des conflits de ressources.
Appelez CM_Get_Resource_Conflict_Details pour chaque entrée dans la liste des conflits.

Les conflits suivants ne sont généralement pas signalés :

S’il existe plusieurs conflits pour une ressource et que les propriétaires de certains des conflits peuvent être déterminés, les conflits sans propriétaires identifiables ne sont pas signalés.
Les conflits qui semblent être avec l’appareil spécifié (autrement dit, l’appareil est en conflit avec lui-même) ne sont pas signalés.
Si plusieurs appareils non Plug-and-Play utilisent le même pilote, les conflits de ressources entre ces appareils peuvent ne pas être signalés.

Parfois, les ressources affectées au HAL peuvent être signalées comme étant en conflit avec le HAL ou non disponibles.

Configuration requise


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib

Partager via