IRP_MN_QUERY_DEVICE_RELATIONS
El administrador de PnP envía esta solicitud para determinar determinadas relaciones entre dispositivos. Los siguientes tipos de controladores controlan esta solicitud:
Los controladores de autobús deben controlar las solicitudes de BusRelations para su adaptador o controlador (FDO de bus). Los controladores de filtro pueden controlar las solicitudes de BusRelations .
Los controladores de autobús deben controlar las solicitudes TargetDeviceRelation para sus dispositivos secundarios (PPO secundarios).
Los controladores de función y filtro pueden controlar las solicitudes RemovalRelations y PowerRelations .
Los controladores de autobús pueden controlar las solicitudes de EjectionRelations para sus dispositivos secundarios (PPO secundarios).
Value
0x07
Código principal
Cuándo se envió
El administrador de PnP envía este IRP para recopilar información sobre los dispositivos con una relación con el dispositivo especificado.
El administrador de PnP consulta las BusRelations (dispositivos secundarios) de un dispositivo cuando el dispositivo se enumera y en otros momentos mientras el dispositivo está activo, como cuando un controlador llama a la rutina IoInvalidateDeviceRelations para indicar que un dispositivo secundario ha llegado o salido.
El administrador de PnP consulta las RemoveRelations de un dispositivo antes de quitar los controladores de un dispositivo. El administrador de PnP consulta removalRelations y EjectionRelations antes de expulsar un dispositivo.
El administrador de PnP consulta targetDeviceRelation de un dispositivo cuando se registra un controlador o una aplicación en modo de usuario para la notificación PnP de un EventCategoryTargetDeviceChange en el dispositivo. El administrador de PnP consulta el dispositivo asociado a un objeto de archivo determinado. IRP_MN_QUERY_DEVICE_RELATIONS es el único IRP de PnP que tiene un parámetro de objeto de archivo válido. Un controlador puede consultar una pila de dispositivos para TargetDeviceRelation. Un controlador no necesita proporcionar un objeto de archivo al enviar su consulta TargetDeviceRelation .
El administrador de PnP consulta powerRelations de un dispositivo cuando el controlador del dispositivo llama a IoInvalidateDeviceRelations para indicar que el conjunto de dispositivos con los que este dispositivo tiene una relación implícita de administración de energía ha cambiado. Las solicitudes de PowerRelations se admiten a partir de Windows 7.
En el caso de las solicitudes BusRelations, RemovalRelations, EjectionRelations y PowerRelations , el administrador de PnP envía IRP_MN_QUERY_DEVICE_RELATIONS en IRQL = PASSIVE_LEVEL en el contexto de un subproceso del sistema.
Para las solicitudes TargetDeviceRelation , el administrador de PnP envía este IRP a IRQL = PASSIVE_LEVEL en un contexto arbitrario de subprocesos.
Parámetros de entrada
El miembro Parameters.QueryDeviceRelations.Type de la estructura IO_STACK_LOCATION especifica el tipo de relaciones que se consultan. Entre los valores posibles se incluyen BusRelations, EjectionRelations, RemovalRelations, TargetDeviceRelation y PowerRelations.
El miembro FileObject de la estructura IO_STACK_LOCATION actual apunta a un objeto de archivo válido solo si Parameters.QueryDeviceRelations.Type es TargetDeviceRelation.
Parámetros de salida
Se devuelve en el bloque de estado de E/S.
Bloque de estado de entrada/salida
Un controlador establece Irp-IoStatus.Status> en STATUS_SUCCESS o en un estado de error, como STATUS_INSUFFICIENT_RESOURCES.
Si se ejecuta correctamente, un controlador establece Irp-IoStatus.Information> en un puntero PDEVICE_RELATIONS que apunta a la información de relaciones solicitada. La estructura DEVICE_RELATIONS se define de la siguiente manera:
typedef struct _DEVICE_RELATIONS {
ULONG Count;
PDEVICE_OBJECT Objects[1]; // variable length
} DEVICE_RELATIONS, *PDEVICE_RELATIONS;
Operación
Si un controlador devuelve relaciones en respuesta a este IRP_MN_QUERY_DEVICE_RELATIONS, el controlador asigna una estructura DEVICE_RELATIONS de la memoria paginada que contiene un recuento y el número adecuado de punteros de objeto de dispositivo. El administrador de PnP libera la estructura cuando ya no es necesaria. Si un controlador reemplaza una estructura de DEVICE_RELATIONS que asignó otro controlador, el controlador debe liberar la estructura anterior.
Un controlador debe hacer referencia al PDO de cualquier dispositivo que informe en este IRP (ObReferenceObject). El administrador de PnP quita la referencia cuando corresponda.
Una función o un controlador de filtro deben estar preparados para controlar este IRP para un dispositivo en cualquier momento después de que se haya completado su rutina AddDevice para el dispositivo. Los controladores de autobús deben estar preparados para controlar una consulta de BusRelations inmediatamente después de enumerar un dispositivo.
Para conocer las reglas generales sobre el control de Plug and Play IRP menores, consulte Plug and Play.
En las subsecciones siguientes se describen las acciones específicas para controlar las distintas consultas.
Solicitud de BusRelations
Cuando el administrador de PnP consulta las relaciones de bus (dispositivos secundarios) de un adaptador o controlador, el controlador del bus debe devolver una lista de punteros a los PPO de cualquier dispositivo presente físicamente en el bus. El controlador de autobús informa de todos los dispositivos, independientemente de si se han iniciado. Es posible que el controlador de autobús necesite encender su dispositivo de autobús para determinar qué elementos secundarios están presentes.
Advertencia Un objeto de dispositivo no se puede pasar a ninguna rutina que tome un PDO como argumento hasta que el administrador de PnP cree un nodo de dispositivo (devnode) para ese objeto. (Si el controlador pasa un objeto de dispositivo, el sistema comprobará errores con la comprobación de errores 0xCA: PNP_DETECTED_FATAL_ERROR). El administrador de PnP crea el devnode en respuesta a la solicitud IRP_MN_QUERY_DEVICE_RELATIONS . El controlador puede suponer de forma segura que se ha creado el nodo de desarrollo del PDO cuando recibe una solicitud de IRP_MN_QUERY_RESOURCE_REQUIREMENTS .
El controlador de bus que responde a este IRP es el controlador de función para el adaptador o controlador de bus, no el controlador primario del bus al que está conectado el adaptador o controlador. Los controladores de función para dispositivos que no son de bus no controlan esta consulta. Estos controladores simplemente pasan el IRP al siguiente controlador inferior. (Vea la ilustración siguiente). Normalmente, los controladores de filtro no controlan esta consulta.
En Windows Vista y los sistemas operativos posteriores, se recomienda que los controladores siempre lápiz el IRP de IRP_MN_QUERY_DEVICE_RELATIONS y completen su procesamiento más adelante. Este orden permite al sistema procesar las consultas de relación de bus de forma asincrónica. (En los sistemas operativos antes de Windows Vista, los controladores pueden devolver STATUS_PENDING de forma segura desde sus rutinas de envío, pero el administrador de PnP no se superpone a la consulta de relación de bus con ninguna otra operación).
En el diagrama siguiente se muestra cómo los controladores controlan una consulta para las relaciones de autobús.
En el ejemplo que se muestra en la ilustración, el administrador de PnP envía un IRP_MN_QUERY_DEVICE_RELATIONS para BusRelations a los controladores del dispositivo concentrador USB. El administrador de PnP solicita una lista de los elementos secundarios del dispositivo concentrador.
Al igual que con todos los IRP de PnP, el administrador de PnP envía el IRP al controlador superior de la pila de dispositivos para el dispositivo.
Un controlador de filtro opcional podría ser el controlador superior de la pila. Normalmente, un controlador de filtro no controla este IRP; pasa el IRP por la pila. Un controlador de filtro puede controlar este IRP, por ejemplo, si el controlador expone un dispositivo no enumerable en el bus.
El controlador del bus del concentrador USB controla el IRP.
El controlador del bus del concentrador USB:
Crea un PDO para cualquier dispositivo secundario que aún no tenga uno.
Marca el PDO inactivo para cualquier dispositivo que ya no esté presente en el bus. El controlador de bus no elimina estos PPO. Para obtener más información sobre cuándo eliminar los PPO, consulte Eliminación de un dispositivo.
Notifica cualquier dispositivo secundario que esté presente en el bus.
Para cada dispositivo secundario, el controlador de bus hace referencia al PDO y coloca un puntero al PDO en la estructura DEVICE_RELATIONS.
Hay dos PPO en este ejemplo: uno para el dispositivo joystick y otro para el dispositivo de teclado.
El controlador de autobús debe comprobar si otro controlador ya ha creado una estructura de DEVICE_RELATIONS para este IRP. Si es así, el controlador de autobús debe agregar a la información existente.
Si no hay ningún dispositivo secundario presente en el bus, el controlador establece el recuento en cero en la estructura DEVICE_RELATIONS y devuelve el éxito.
Establece los valores adecuados en el bloque de estado de E/S y pasa el IRP al siguiente controlador inferior. El controlador de bus para el adaptador o controlador no completa el IRP.
Un filtro inferior opcional, si está presente, normalmente no controla este IRP. Este controlador de filtro pasa el IRP por la pila. Si un controlador de filtro inferior controla este IRP, puede agregar PDO a la lista de dispositivos secundarios, pero no debe eliminar los archivos PDO creados por otros controladores.
El controlador de bus primario no controla este IRP, a menos que sea el único controlador de la pila de dispositivos (el dispositivo está en modo sin procesar). Al igual que con todos los IRP de PnP, el controlador de autobús primario completa el IRP con IoCompleteRequest.
Si hay uno o varios controladores de filtro de bus en la pila de dispositivos, estos controladores pueden controlar el IRP en su camino hacia el controlador de autobús o en la forma de hacer una copia de seguridad de la pila del dispositivo (si hay rutinas de IoCompletion ). Según las reglas de IRP de PnP, este controlador puede agregar PnP PnP a IRP en su camino hacia abajo de la pila o modificar la lista de relaciones en el camino de copia de seguridad de la pila de IRP (en rutinas de IoCompletion ).
Solicitud de EjectionRelations
Un controlador devuelve punteros a PPO de cualquier dispositivo que se pueda quitar físicamente del sistema cuando se expulsa el dispositivo especificado. No notifique los PPO de los elementos secundarios del dispositivo; El administrador de PnP siempre solicita que los dispositivos secundarios se quiten antes de su dispositivo primario.
El administrador de PnP envía una IRP_MN_EJECT IRP a un dispositivo que se va a expulsar. El controlador de este tipo de dispositivo también recibe un IRP de eliminación. Las relaciones de expulsión del dispositivo reciben un IRP de IRP_MN_REMOVE_DEVICE (no un IRP de IRP_MN_EJECT ).
Solo un controlador de autobús primario puede responder a una consulta de EjectionRelations para uno de sus dispositivos secundarios. Los controladores de función y filtro deben pasarlo al siguiente controlador inferior de la pila de dispositivos. Si un controlador de autobús recibe este IRP como controlador de función para su adaptador o controlador, el controlador de bus está realizando las tareas de un controlador de función y debe pasar el IRP al siguiente controlador inferior.
Solicitud de PowerRelations
A partir de Windows 7, la consulta de PowerRelations permite a un controlador especificar una relación de administración de energía fuera de la relación convencional entre un bus primario que admita la enumeración PnP y un dispositivo secundario enumerado en el bus. Por ejemplo, si un controlador de bus no puede enumerar un dispositivo secundario en el bus, o si un dispositivo es un elemento secundario de más de un bus, la consulta de PowerRelations puede describir las relaciones de potencia del dispositivo secundario con el bus o los autobuses.
El administrador de PnP emite una consulta de PowerRelations para un dispositivo cuando el controlador del dispositivo llama a la rutina IoInvalidateDeviceRelations y especifica un valor de parámetro Type de PowerRelations.
En respuesta a esta consulta, el controlador para el dispositivo de destino (es decir, el dispositivo que es el destino de la consulta) proporciona una estructura DEVICE_RELATIONS que contiene punteros a los PPO de cualquier otro dispositivo que el administrador de energía deba activar antes de activar el dispositivo de destino. Por el contrario, estos otros dispositivos deben desactivarse solo después de que el dispositivo de destino esté desactivado. El administrador de energía usa la información de la consulta para garantizar que estos dispositivos están activados y desactivados en el orden correcto.
Esta garantía de ordenación solo se aplica a las transiciones de estado de suspensión del sistema global, que incluyen transiciones hacia y desde los estados de energía del sistema S1, S2, S3 (suspensión), S4 (hibernación) y S5 (apagado). La garantía de ordenación de PowerRelations no se aplica a las transiciones de estado de energía del dispositivo Dx mientras el sistema permanece en el estado del sistema S0 (en ejecución), excepto en el caso de transiciones de Administración de energía en tiempo de ejecución dirigida (DFx).
Si el dispositivo de destino está en la ruta de acceso del dispositivo para un archivo especial (como el archivo de paginación, el archivo de hibernación o el archivo de volcado de memoria), el controlador del dispositivo de destino debe realizar un paso adicional cuando controla un IRP de IRP_MN_DEVICE_USAGE_NOTIFICATION en el que InPath es TRUE. Este controlador debe asegurarse de que los dispositivos cuyos PPO se suministran para la consulta de PowerRelations también pueden admitir que estén en la ruta de acceso del dispositivo para el archivo especial. Para confirmar esta compatibilidad, el controlador para el dispositivo de destino debe enviar primero el irP de IRP_MN_DEVICE_USAGE_NOTIFICATION a cada uno de estos dispositivos y este IRP debe especificar el mismo usageNotification.Type que el dispositivo de destino. Solo si todos los dispositivos que reciben este IRP completan el IRP con un código de estado correcto, el controlador del dispositivo de destino completa su IRP_MN_DEVICE_USAGE_NOTIFICATION IRP correctamente. De lo contrario, este controlador debe completar este IRP con un código de estado de error.
Cuando este mismo controlador controla un IRP_MN_DEVICE_USAGE_NOTIFICATION IRP para el que InPath es FALSE, el controlador debe enviar la IRP_MN_DEVICE_USAGE_NOTIFICATION IRP al mismo conjunto de dispositivos dependientes que para el caso en el que InPath es TRUE. Sin embargo, el controlador nunca debe completar este IRP con un código de estado de error cuando InPath es FALSE.
El controlador que responde a la consulta de PowerRelations debe registrarse para recibir notificaciones de cambio de dispositivo de destino en todos los dispositivos cuyos PPO se proporcionan para la consulta de PowerRelations . Para registrarse para estas notificaciones, el controlador puede llamar a la rutina IoRegisterPlugPlayNotification y especificar un valor de parámetro EventCategory de EventCategoryTargetDeviceChange.
Solicitud removalRelations
Un controlador devuelve punteros a PPO de cualquier dispositivo cuyos controladores se deben quitar cuando se quitan los controladores del dispositivo especificado. No notifique los PPO de los elementos secundarios del dispositivo; El administrador de PnP ya solicita la eliminación de dispositivos secundarios antes de quitar un dispositivo.
El orden en que se quitan las relaciones de eliminación no está definido.
Cualquier controlador de la pila de dispositivos puede controlar este tipo de consulta de relaciones. Una función o un controlador de filtro controla el IRP antes de pasarlo al siguiente controlador inferior. Un controlador de autobús controla el IRP y, a continuación, lo completa.
Solicitud TargetDeviceRelation
La consulta TargetDeviceRelation permite al administrador de PnP consultar una pila de dispositivos que no sea PnP para el PDO en la pila de dispositivos PnP que controla el hardware.
En general, los controladores reenvía el IRP_MN_QUERY_DEVICE_RELATIONS IRP hacia abajo hasta que el IRP llega a la parte inferior de una pila de dispositivos determinada. Un controlador situado en la parte inferior de una pila que no sea PnP reenvía o vuelve a enviar el IRP a la pila PnP correspondiente. Por ejemplo, el administrador de PnP podría enviar una consulta TargetDeviceRelation al objeto de dispositivo en la parte superior de la pila del sistema de archivos, que es una pila que no es PnP. Cada objeto de dispositivo de la pila del sistema de archivos pasaría la consulta al objeto de dispositivo debajo hasta que la consulta alcanzase el objeto de dispositivo en la parte inferior de la pila. El objeto de dispositivo más bajo de la pila reenviaría o volvería a emitir la consulta TargetDeviceRelation al objeto de dispositivo en la parte superior de la pila de volúmenes de almacenamiento PnP y, a continuación, la consulta se pasaría al PDO en la parte inferior de la pila de volúmenes de almacenamiento.
En la lista siguiente se resumen las situaciones en las que puede adquirir de forma segura un puntero al PDO en la parte inferior de una pila de dispositivos PnP:
Objeto device en un PnP
Un objeto de dispositivo que se encuentra en una pila de dispositivos PnP aprende sobre el PDO de la pila cuando se llama a la rutina AddDevice para el dispositivo. El controlador puede almacenar en caché de forma segura el puntero al PDO si el uso del puntero se sincroniza correctamente con los mensajes entrantes IRP_MN_REMOVE_DEVICE mediante las rutinas de bloqueo de eliminación.
Objeto de dispositivo en una pila que no es PnP, no en la parte inferior de la pila
Para un objeto de dispositivo que no está en la parte inferior de una pila que no es PnP, un controlador puede enviar una consulta TargetDeviceRelation para obtener un puntero al PDO en la parte inferior de la pila de dispositivos PnP correspondiente.
Objeto de archivo para el dispositivo
Dado un objeto de archivo para el dispositivo, un controlador puede llamar a IoGetRelatedDeviceObject para obtener el objeto de dispositivo y, a continuación, seguir las instrucciones del elemento de lista anterior.
Identificador del objeto de dispositivo
Dado un identificador al objeto de dispositivo, un controlador puede llamar a ObReferenceObjectByHandle para obtener el objeto de archivo del dispositivo y, a continuación, seguir las instrucciones del elemento de lista anterior.
Un controlador de bus primario debe controlar una consulta de relaciones TargetDeviceRelation para sus dispositivos secundarios. El controlador de bus hace referencia al PDO del dispositivo secundario con ObReferenceObject y devuelve un puntero al PDO en la estructura DEVICE_RELATIONS . Solo hay un puntero PDO en la estructura para este tipo de relación. El administrador de PnP quita la referencia al PDO cuando el controlador o la aplicación anula el registro de notificación en el dispositivo.
Solo un controlador de autobús primario responde a una consulta TargetDeviceRelation . Los controladores de función y filtro deben pasarlo al siguiente controlador inferior de la pila de dispositivos. Si un controlador de autobús recibe este IRP como controlador de función para su adaptador o controlador, el controlador de bus está realizando las tareas de un controlador de función y debe pasar el IRP al siguiente controlador inferior.
Si un controlador no está en una pila basada en PDO, el controlador envía un nuevo IRP de consulta de relación de dispositivo de destino al objeto de dispositivo asociado al identificador de archivo en el que el controlador realiza E/S.
Envío de este IRP
Los controladores no deben enviar IRP_MN_QUERY_DEVICE_RELATIONS para solicitar BusRelations. Los controladores no están restringidos a enviar este IRP para RemovalRelations o EjectionRelations, pero no es probable que un controlador lo haga.
Los controladores pueden consultar una pila de dispositivos para TargetDeviceRelation. Consulte Control de IRP para obtener información sobre el envío de IRP. Los pasos siguientes se aplican específicamente a este IRP:
Establezca los valores en la siguiente ubicación de pila de E/S del IRP: establezca MajorFunction en IRP_MJ_PNP, establezca MinorFunction en IRP_MN_QUERY_DEVICE_RELATIONS, establezca Parameters.QueryDeviceRelations.Type en TargetDeviceRelation y establezca Irp-FileObject> en un objeto de archivo válido.
Inicialice IoStatus.Status en STATUS_NOT_SUPPORTED.
Si un controlador envió este IRP para obtener el PDO para informar en respuesta a un IRP_MN_QUERY_DEVICE_RELATIONS para TargetDeviceRelation que recibió el controlador, el controlador notifica el PDO y libera la estructura de relaciones devuelta cuando se completa el IRP. Si un controlador inició este IRP por otro motivo, el controlador libera la estructura de relaciones cuando el IRP finaliza y desreferencia el PDO cuando ya no es necesario.
Requisitos
Encabezado |
Wdm.h (incluya Wdm.h, Ntddk.h o Ntifs.h) |
Consulte también
IoRegisterPlugPlayNotification
IRP_MN_DEVICE_USAGE_NOTIFICATION