DEVPKEY_Device_BaseContainerId

La propiedad de dispositivo DEVPKEY_Device_BaseContainerId representa el valor GUID del identificador de contenedor base (ID). El administrador de windows Plug and Play (PnP) asigna este valor al nodo de dispositivo (devnode).

Atributo Valor
Clave de propiedad DEVPKEY_Device_BaseContainerId
Identificador de tipo de datos de propiedad DEVPROP_TYPE_GUID
Property Access Acceso de solo lectura mediante aplicaciones de instalación e instaladores.
Identificador SPDRP_Xxx correspondiente SPDRP_BASE_CONTAINERID
¿Localizada? No

Observaciones

El administrador de PnP determina el identificador de contenedor de un nodo de desarrollo mediante uno de los métodos siguientes:

  • Un controlador de bus proporciona un identificador de contenedor.

    Cuando el administrador de PnP asigna un identificador de contenedor a un nodo de desarrollo, comprueba primero si el controlador de bus del nodo dev puede proporcionar un identificador de contenedor. Los controladores de bus proporcionan un identificador de contenedor a través de una solicitud de consulta IRP_MN_QUERY_ID con el campo Parameters.QueryId.IdType establecido en BusQueryContainerID.

  • El administrador de PnP genera un identificador de contenedor mediante la funcionalidad de dispositivo extraíble.

    Si un controlador de bus no puede proporcionar un identificador de contenedor para un nodo de desarrollo que está enumerando, el administrador de PnP usa la funcionalidad del dispositivo extraíble para generar un identificador de contenedor para todos los nodos de desarrollo enumerados para el dispositivo. El controlador de bus informa de esta funcionalidad del dispositivo en respuesta a una solicitud de IRP_MN_QUERY_CAPABILITIES .

  • El administrador de PnP genera un identificador de contenedor mediante una invalidación de la funcionalidad del dispositivo extraíble.

    Aunque el mecanismo de invalidación no cambia el valor de la funcionalidad del dispositivo extraíble, obliga al administrador de PnP a usar la configuración de invalidación y no al valor de la funcionalidad del dispositivo extraíble cuando genera identificadores de contenedor para los dispositivos.

Para obtener más información sobre estos métodos, consulte Cómo se generan los identificadores de contenedor.

Independientemente de cómo se obtenga el valor del identificador de contenedor, el administrador de PnP asigna el valor a la propiedad DEVPKEY_Device_BaseContainerId del nodo dev.

La propiedad DEVPKEY_Device_BaseContainerId se puede usar para forzar la agrupación de un nuevo devnode con otros devnodes que existen en el sistema. Esto le permite usar el nuevo devnode como identificador de contenedor primario (o base) para otros devnodes relacionados. Para ello, primero debe obtener el GUID DEVPKEY_Device_BaseContainerID del nodo de desarrollo existente. A continuación, debe devolver el GUID de identificador de contenedor del nuevo nodo de desarrollo en respuesta a una solicitud de consulta IRP_MN_QUERY_ID que tenga el campo Parameters.QueryId.IdType establecido en BusQueryContainerID.

Nota:

El valor devuelto por una consulta de las propiedades DEVPKEY_Device_BaseContainerId o DEVPKEY_Device_ContainerId puede ser diferente para el mismo devnode.

Nota:

No use la propiedad DEVPKEY_Device_BaseContainerId para reconstruir agrupaciones de contenedores de dispositivos en el sistema. Use la propiedad DEVPKEY_Device_ContainerId en su lugar.

Para obtener más información sobre los identificadores de contenedor, consulte Identificadores de contenedor.

Requisitos

Versión: Windows 7 y versiones posteriores de Windows

Encabezado: Devpkey.h (incluya Devpkey.h)

Consulte también

Identificadores de contenedores

DEVPKEY_Device_ContainerId

SetupDiGetDeviceProperty