funzione CM_Query_Resource_Conflict_List (cfgmgr32.h)

Articolo
02/28/2024

La funzione CM_Query_Resource_Conflict_List identifica le istanze del dispositivo con requisiti di risorsa in conflitto con la descrizione della risorsa di un'istanza del dispositivo specificata.

Sintassi

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
);

Parametri

[out] pclConflictList

Indirizzo fornito dal chiamante di una posizione per ricevere un handle in un elenco di conflitti.

[in] dnDevInst

Handle di istanza del dispositivo fornito dal chiamante associato all'handle del computer fornito da hMachine.

[in] ResourceID

Identificatore del tipo di risorsa fornito dal chiamante. Questa deve essere una delle costanti con prefisso ResType_ definite in Cfgmgr32.h.

[in] ResourceData

Puntatore fornito dal chiamante a un descrittore di risorse, che può essere una delle strutture elencate nella descrizione della funzione CM_Add_Res_Des di ResourceData.

[in] ResourceLen

Lunghezza fornita dal chiamante della struttura a cui fa riferimento ResourceData.

[in] ulFlags

Non usato, deve essere zero.

[in, optional] hMachine

Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del chiamante fornito dal chiamante.

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.

Nota A partire da Windows 8, CM_Query_Resource_Conflict_List restituisce CR_CALL_NOT_IMPLEMENTED quando viene usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.

Commenti

Quando si chiama CM_Query_Resource_Conflict_List, specificare un handle di istanza del dispositivo e un descrittore di risorse. I descrittori di risorse per i nodi del dispositivo esistenti possono essere ottenuti chiamando CM_Get_Res_Des_Data. Questi parametri indicano le risorse specifiche da usare per un dispositivo specifico. L'elenco dei conflitti risultante identifica i dispositivi che usano le stesse risorse, insieme alle risorse riservate dal computer.

Dopo aver chiamato CM_Query_Resource_Conflict_List, un'applicazione può chiamare CM_Get_Resource_Conflict_Count per determinare il numero di conflitti contenuti nell'elenco dei conflitti di risorse. Il numero di conflitti può essere zero. L'applicazione può quindi chiamare CM_Get_Resource_Conflict_Details per ogni voce nell'elenco dei conflitti.

Dopo aver completato l'uso dell'handle ricevuto per pclConflictList, deve chiamare CM_Free_Resource_Conflict_Handle.

Per informazioni sull'uso degli handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.

Requisiti

Requisito	Valore
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
DLL	Cfgmgr32.dll