WdfPdoAddEjectionRelationsPhysicalDevice-Funktion (wdfpdo.h)

[Gilt nur für KMDF]

Die WdfPdoAddEjectionRelationsPhysicalDevice Methode gibt an, dass ein angegebenes Gerät ausgeworfen wird, wenn ein anderes angegebenes Gerät ausgeworfen wird.

Syntax

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

Die 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 die Methode STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

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

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

Bemerkungen

Der parameter PhysicalDevice verweist auf einen PDO eines Geräts, das ausgeworfen wird, wenn das Gerät, das durch Device identifiziert wird, ausgelöst wird. In der Regel werden beide Geräte vom aufrufenden Treiber gesteuert. Melden Sie die untergeordneten Geräte von Device nicht, da beim Auswerfen eines übergeordneten Geräts auch die untergeordneten Geräte des Geräts ausgeworfen werden.

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

Beispiele

Im folgenden Codebeispiel wird ein Gerät hinzugefügt, das das pPhysicalDeviceObject Struktur der Liste der Geräte darstellt, die ausgeworfen werden, wenn das Gerät, das Gerät angibt, ausgeworfen wird.

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

Anforderungen

Siehe auch

WdfPdoClearEjectionRelationsDevices

WdfPdoRemoveEjectionRelationsPhysicalDevice