CM_Query_Resource_Conflict_List función (cfgmgr32.h)

La función CM_Query_Resource_Conflict_List identifica las instancias de dispositivo que tienen requisitos de recursos que entran en conflicto con la descripción del recurso de una instancia de dispositivo especificada.

Sintaxis

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

Dirección proporcionada por el autor de la llamada de una ubicación para recibir un identificador de una lista de conflictos.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada enlazado al identificador de la máquina proporcionado por hMachine.

[in] ResourceID

Identificador de tipo de recurso proporcionado por el autor de la llamada. Debe ser una de las constantes ResType_ prefijo definidas en Cfgmgr32.h.

[in] ResourceData

Puntero proporcionado por el autor de la llamada a un descriptor de recursos, que puede ser una de las estructuras enumeradas en la descripción de resourceData de la función CM_Add_Res_Des.

[in] ResourceLen

Longitud proporcionada por el autor de la llamada de la estructura a la que apunta ResourceData.

[in] ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

Identificador de equipo proporcionado por el autor de la llamada al que está enlazado el identificador de instancia del dispositivo proporcionado por el autor de la llamada.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Query_Resource_Conflict_List devuelve CR_CALL_NOT_IMPLEMENTED cuando se usa en un escenario de Wow64. Para solicitar información sobre los recursos de hardware en un equipo local, es necesario implementar una versión nativa de la arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.

 

Comentarios

Al llamar a CM_Query_Resource_Conflict_List, especifique un identificador de instancia de dispositivo y un descriptor de recursos. (Los descriptores de recursos para los nodos de dispositivo existentes se pueden obtener llamando a CM_Get_Res_Des_Data). Estos parámetros indican los recursos específicos que desea usar un dispositivo específico. La lista de conflictos resultante identifica los dispositivos que usan los mismos recursos, junto con los recursos reservados por la máquina.

Después de llamar a CM_Query_Resource_Conflict_List, una aplicación puede llamar a CM_Get_Resource_Conflict_Count para determinar el número de conflictos contenidos en la lista de conflictos de recursos. (El número de conflictos puede ser cero). A continuación, la aplicación puede llamar a CM_Get_Resource_Conflict_Details para cada entrada de la lista de conflictos.

Una vez que una aplicación haya terminado de usar el identificador recibido para pclConflictList, debe llamar a CM_Free_Resource_Conflict_Handle.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib
Archivo DLL	Cfgmgr32.dll

Consulte también

CM_Free_Resource_Conflict_Handle

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details