Funzione IoInvalidateDeviceRelations (wdm.h)

La routine IoInvalidateDeviceRelations notifica al gestore PnP che le relazioni per un dispositivo,ad esempio relazioni di bus, relazioni di espulsione, relazioni di rimozione e relazione del dispositivo di destinazione sono state modificate.

Sintassi

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

Parametri

[in] DeviceObject

Puntatore al PDO per il dispositivo.

[in] Type

Specifica un valore di enumerazione DEVICE_RELATION_TYPE che descrive il tipo di relazioni modificate. I valori possibili includono BusRelations, EjectionRelations, RemovalRelations e TargetDeviceRelation. A partire da Windows 7, il valore di PowerRelations è supportato anche.

Valore restituito

nessuno

Osservazioni

Per alcuni tipi di relazione, ad esempio BusRelations, questa routine causa la raccolta di informazioni sulle relazioni aggiornate tramite l'invio di una richiesta di IRP_MN_QUERY_DEVICE_RELATIONS ai driver per il dispositivo. Per altri tipi di relazione, ad esempio EjectionRelations, la gestione PnP non deve raccogliere immediatamente nuove informazioni sulle relazioni; Il gestore PnP esegue query sui driver per le relazioni di esezione solo quando si prepara a esettare un dispositivo.

Dopo che un driver del bus chiama IoInvalidateDeviceRelations per informare il gestore PnP che un dispositivo è scomparso, il driver del bus deve continuare a gestire PnP IRP per quel dispositivo fino a quando non riceve una richiesta di IRP_MN_REMOVE_DEVICE . In risposta a questa IRP, il driver del bus restituisce STATUS_NO_SUCH_DEVICE. Fino a quando il driver del bus non completa correttamente la richiesta di IRP_MN_REMOVE_DEVICE , il driver del bus può accedere all'estensione del dispositivo per controllare i flag per il dispositivo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport)

Vedi anche

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE