Função IoInvalidateDeviceRelations (wdm.h)

  • Artigo

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.

Sintaxe

void IoInvalidateDeviceRelations(
  [in] PDEVICE_OBJECT       DeviceObject,
  [in] DEVICE_RELATION_TYPE Type
);

Parâmetros

[in] DeviceObject

Ponteiro para o PDO do 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, EjectionRelations, RemovalRelations e TargetDeviceRelation. A partir do Windows 7, também há suporte para o valor do PowerRelations .

Retornar valor

Nenhum

Comentários

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 de IRP_MN_QUERY_DEVICE_RELATIONS para os drivers do dispositivo. Para outros tipos de relação, como EjeçãoRelations, o gerenciador PnP não precisa coletar novas informações de relação imediatamente; o gerenciador de 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 marcar seus sinalizadores para o dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport)

Confira também

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE