WdfDeviceAddRemovalRelationsPhysicalDevice-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfDeviceAddRemovalRelationsPhysicalDevice Methode gibt an, dass ein angegebenes Gerät entfernt werden muss, wenn ein anderes angegebenes Gerät entfernt wird.

Syntax

NTSTATUS WdfDeviceAddRemovalRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] PhysicalDevice

Ein Zeiger auf eine vom Aufrufer bereitgestellte DEVICE_OBJECT Struktur, die ein physisches Geräteobjekt (PDO) darstellt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceAddRemovalRelationsPhysicalDevice STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	PhysicalDevice- ist NULL-.
STATUS_INSUFFICIENT_RESOURCES	Fehler bei der Speicherzuweisung.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Der parameter PhysicalDevice verweist auf einen PDO eines Geräts, dessen Treiber entfernt werden müssen, wenn die Treiber für Device entfernt werden. In der Regel werden beide Geräte vom aufrufenden Treiber gesteuert. Melden Sie nicht die untergeordneten Geräte des in Device angegebenen Geräteobjekts, da beim Entfernen des Plug-and-Play-Managers ein übergeordnetes Gerät auch die untergeordneten Geräte des Geräts entfernt werden.

Ihr Treiber kann WdfDeviceAddRemovalRelationsPhysicalDevice mehrmals aufrufen, um der Liste der Geräte mehrere Geräte hinzuzufügen, die entfernt werden müssen, wenn Device entfernt wird. Die Reihenfolge, in der die angegebenen Geräte entfernt werden, ist nicht definiert.

Beispiele

Im folgenden Codebeispiel wird das Gerät hinzugefügt, das pPdo- der Liste der Geräte identifiziert, die entfernt werden müssen, wenn das Gerät, das Gerät angibt, entfernt wird.

status = WdfDeviceAddRemovalRelationsPhysicalDevice(
                                                    device,
                                                    pPdo
                                                    );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfDeviceClearRemovalRelationsDevices

WdfDeviceRemoveRemovalRelationsPhysicalDevice

Freigeben über