Função IoInvalidateDeviceRelations (wdm.h)
A rotina IoInvalidateDeviceRelations notifica o gerente PnP de que as relações de um dispositivo (como relações de barramento, relações de ejeção, relações de remoção e relação de dispositivo de destino) foram alteradas.
void IoInvalidateDeviceRelations(
[in] PDEVICE_OBJECT DeviceObject,
[in] DEVICE_RELATION_TYPE Type
);
[in] DeviceObject
Ponteiro para o PDO para o dispositivo.
[in] Type
Especifica um valor de enumeração DEVICE_RELATION_TYPE que descreve o tipo de relações que foram alteradas. Os valores possíveis incluem BusRelations, JeionRelations, RemovalRelationse TargetDeviceRelation. A partir do Windows 7, também há suporte para o powerrelations valor.
Nenhum
Para alguns tipos de relação, como BusRelations, essa rotina faz com que o gerenciador de PnP ou o power manager colete informações de relações atualizadas enviando uma solicitação IRP_MN_QUERY_DEVICE_RELATIONS para os drivers do dispositivo. Para outros tipos de relação, como EjeçõesRelations, o gerenciador PnP não precisa coletar novas informações de relação imediatamente; o gerenciador PnP consulta drivers para relações de ejeção somente quando está se preparando para ejetar um dispositivo.
Depois que um motorista de ônibus chama IoInvalidateDeviceRelations para informar ao gerenciador PnP que um dispositivo desapareceu, o motorista do ônibus deve continuar a manipular IRPs PnP para esse dispositivo até receber uma solicitação de IRP_MN_REMOVE_DEVICE. Em resposta a esse IRP, o motorista do ônibus retorna STATUS_NO_SUCH_DEVICE. Até que o motorista do ônibus conclua com êxito a solicitação de IRP_MN_REMOVE_DEVICE, o motorista do ônibus poderá acessar a extensão do dispositivo para verificar seus sinalizadores para o dispositivo.