funzione CM_Get_Resource_Conflict_DetailsA (cfgmgr32.h)

La funzione CM_Get_Resource_Conflict_Details ottiene i dettagli relativi a uno dei conflitti di risorsa in un elenco di conflitti.

Sintassi

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

Parametri

[in] clConflictList

Handle fornito dal chiamante a un elenco di conflitti, ottenuto da una chiamata precedente a CM_Query_Resource_Conflict_List.

[in] ulIndex

Valore fornito dal chiamante usato come indice nell'elenco dei conflitti. Questo valore può essere compreso tra zero e uno inferiore al numero restituito da CM_Get_Resource_Conflict_Count.

[in, out] pConflictDetails

Indirizzo fornito dal chiamante di una struttura CONFLICT_DETAILS per ricevere i dettagli del conflitto. Il chiamante deve fornire valori per le strutture CD_ulSize e CD_ulMask della struttura.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

Per determinare i requisiti delle risorse in conflitto tra un dispositivo specificato e altri dispositivi in un computer, seguire questa procedura.

  1. Chiamare CM_Query_Resource_Conflict_List per ottenere un handle a un elenco di conflitti di risorse.
  2. Chiamare CM_Get_Resource_Conflict_Count per determinare il numero di conflitti contenuti nell'elenco dei conflitti di risorse.
  3. Chiamare CM_Get_Resource_Conflict_Details per ogni voce nell'elenco dei conflitti.
I conflitti seguenti non vengono in genere segnalati:
  • Se sono presenti più conflitti per una risorsa e i proprietari di solo alcuni dei conflitti possono essere determinati, i conflitti senza proprietari identificabili non vengono segnalati.
  • I conflitti che sembrano essere con il dispositivo specificato (ovvero, il dispositivo è in conflitto con se stesso) non vengono segnalati.
  • Se più dispositivi non Plug and Play usano lo stesso driver, potrebbero non essere segnalati conflitti di risorse tra questi dispositivi.
In alcuni casi, le risorse assegnate a HAL potrebbero essere segnalate come in conflitto con HAL o non disponibili.

Requisiti

   
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib