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