IoInvalidateDeviceRelations-Funktion (wdm.h)

Die IoInvalidateDeviceRelations Routine benachrichtigt den PnP-Manager darüber, dass sich die Beziehungen für ein Gerät (z. B. Busbeziehungen, Ejection-Beziehungen, Entfernungsbeziehungen und die Zielgerätebeziehung) geändert haben.

Syntax

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

Parameter

[in] DeviceObject

Zeigen Sie auf den 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, RemovalRelationsund TargetDeviceRelation. Ab Windows 7 wird auch der PowerRelations- Wert unterstützt.

Rückgabewert

Nichts

Bemerkungen

Bei einigen Beziehungstypen, z. B. BusRelations, bewirkt diese Routine, dass der PnP-Manager oder Der Power Manager aktualisierte Beziehungsinformationen sammelt, indem eine IRP_MN_QUERY_DEVICE_RELATIONS Anforderung an die Treiber für das Gerät gesendet wird. Bei anderen Beziehungstypen, z. B. EjectionRelations, muss der PnP-Manager keine neuen Beziehungsinformationen sofort sammeln; Der PnP-Manager fragt Treiber nur für Ejection-Beziehungen ab, wenn es zum Auswerfen eines Geräts vorbereitet wird.

Nachdem ein Bustreiber IoInvalidateDeviceRelations aufruft, 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 er eine IRP_MN_REMOVE_DEVICE Anforderung empfängt. Als Reaktion auf diese IRP gibt der Busfahrer 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 Kennzeichnungen für das Gerät zu überprüfen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 2000 verfügbar.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport)

Siehe auch

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE