IoInvalidateDeviceRelations-Funktion (wdm.h)
Die IoInvalidateDeviceRelations-Routine benachrichtigt den PnP-Manager darüber, dass sich die Beziehungen für ein Gerät (z. B. Bus-, Auswurf-, Entfernungs- und Zielgerätebeziehung) geändert haben.
Syntax
void IoInvalidateDeviceRelations(
[in] PDEVICE_OBJECT DeviceObject,
[in] DEVICE_RELATION_TYPE Type
);
Parameter
[in] DeviceObject
Zeiger auf das PDO für das Gerät.
[in] Type
Gibt einen DEVICE_RELATION_TYPE-Enumerationswert an, der den Typ der geänderten Beziehungen beschreibt. Mögliche Werte sind BusRelations, EjectionRelations, RemovalRelations und TargetDeviceRelation. Ab Windows 7 wird auch der PowerRelations-Wert unterstützt.
Rückgabewert
Keine
Bemerkungen
Bei einigen Beziehungstypen, z. B . BusRelations, bewirkt diese Routine, dass der PnP-Manager oder Power Manager aktualisierte Beziehungsinformationen sammelt, indem eine IRP_MN_QUERY_DEVICE_RELATIONS Anforderung an die Treiber für das Gerät gesendet wird. Für andere Beziehungstypen, z. B . EjectionRelations, muss der PnP-Manager keine neuen Beziehungsinformationen sofort sammeln. Der PnP-Manager fragt Treiber nur nach Auswurfbeziehungen ab, wenn er das Auswerfen eines Geräts vorbereitet.
Nachdem ein Bustreiber IoInvalidateDeviceRelations aufgerufen hat , um den PnP-Manager darüber zu informieren, dass ein Gerät verschwunden ist, muss der Bustreiber weiterhin PnP-IRPs für dieses Gerät verarbeiten, bis es eine IRP_MN_REMOVE_DEVICE-Anforderung erhält. Als Reaktion auf diese IRP gibt der Bustreiber STATUS_NO_SUCH_DEVICE zurück. Bis der Bustreiber die IRP_MN_REMOVE_DEVICE Anforderung erfolgreich abgeschlossen hat, kann der Bustreiber auf die Geräteerweiterung zugreifen, um seine Flags für das Gerät zu überprüfen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport) |