WdfPdoRemoveEjectionRelationsPhysicalDevice-Funktion (wdfpdo.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfPdoRemoveEjectionRelationsPhysicalDevice-Methode entfernt ein angegebenes Gerät aus der Liste der Geräte, die ausgeworfen werden müssen, wenn ein anderes angegebenes Gerät ausgeworfen wird.

Syntax

void WdfPdoRemoveEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] PhysicalDevice

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

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Der Parameter PhysicalDevice verweist auf eine PDO eines Geräts, das WdfPdoRemoveEjectionRelationsPhysicalDevice aus der Liste der Geräte entfernt, die ausgeworfen werden müssen, wenn das durch den Device-Parameter dargestellte Gerät ausgeworfen wird.

Weitere Informationen finden Sie unter Unterstützen von auswerfenden Geräten.

Beispiele

Im folgenden Codebeispiel wird das Gerät, das die pPhysicalDeviceObject-Struktur darstellt, aus der Liste der Geräte entfernt, die beim Auswerfen des vom Gerät angegebenen Geräts ausgeworfen werden.

PDEVICE_OBJECT  pPhysicalDeviceObject;
NTSTATUS  status;
...
status = WdfPdoRemoveEjectionRelationsPhysicalDevice(
                                                     device,
                                                     pPhysicalDeviceObject
                                                     );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfpdo.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfPdoAddEjectionRelationsPhysicalDevice

WdfPdoClearEjectionRelationsDevices