IoInvalidateDeviceRelations-Funktion (wdm.h)

  • Artikel

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)

Weitere Informationen

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE