WdfDeviceAddDependentUsageDeviceObject-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfDeviceAddDependentUsageDeviceObject-Methode gibt an, dass ein angegebenes Gerät von einem anderen Gerät abhängt, wenn das angegebene Gerät verwendet wird, um speziellen Dateienzu speichern.

Syntax

NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT DependentDevice
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] DependentDevice

Ein Zeiger auf eine vom Aufrufer bereitgestellte DEVICE_OBJECT Struktur, die ein Gerät identifiziert, das Device.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	DependentDevice- 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

Ihr Treiber kann WdfDeviceAddDependentUsageDeviceObject- aufrufen, um anzugeben, dass das von Device identifizierte Gerät von dem gerät abhängt, das von DependentDeviceidentifiziert wird, wenn Device spezielle Dateien unterstützt. Wenn Ihr Treiber WdfDeviceAddDependentUsageDeviceObjectaufruft, ruft das Framework die EvtDeviceUsageNotification Rückruffunktionen in DependentDevice's Drivers' auf, bevor die EvtDeviceUsageNotification Rückruffunktionen in Gerätetreiber aufgerufen wird.

Ihr Treiber kann WdfDeviceAddDependentUsageDeviceObject mehrmals aufrufen, um mehrere Geräte zu identifizieren, die Device- abhängig sind, um spezielle Dateien zu unterstützen.

Nachdem ein Treiber WdfDeviceAddDependentUsageDeviceObjectaufgerufen hat, kann er WdfDeviceRemoveDependentUsageDeviceObject- aufrufen, um das durch DependentDevice identifizierte Gerät aus der Liste der Geräte zu entfernen, von denen Device abhängt.

Weitere Informationen zu speziellen Dateien finden Sie unter Unterstützende Spezialdateien.

Beispiele

Im folgenden Codebeispiel wird ein Gerät (pDeviceObject) zur Liste der Geräte hinzugefügt, von denen ein anderes Gerät (Device) abhängt.

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

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

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject

Freigeben über