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

Weitere Informationen

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE