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) |