WdfDeviceAddDependentUsageDeviceObject-Funktion (wdfdevice.h)

Artikel
02/29/2024

[Gilt nur für KMDF]

Die WdfDeviceAddDependentUsageDeviceObject-Methode gibt an, dass ein angegebenes Gerät von einem anderen Gerät abhängig ist, wenn das angegebene Gerät zum Speichern spezieller Dateien verwendet wird.

Syntax

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

Parameter

[in] Device

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

[in] DependentDevice

Ein Zeiger auf eine vom Anrufer bereitgestellte DEVICE_OBJECT Struktur, die ein Gerät identifiziert, von dem Device abhängig ist.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die 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-Werte zurück.

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

Hinweise

Ihr Treiber kann WdfDeviceAddDependentUsageDeviceObject aufrufen, um anzugeben, dass das von Device identifizierte Gerät von dem von DependentDevice identifizierten Gerät abhängt, wenn Device spezielle Dateien unterstützt. Wenn Ihr Treiber WdfDeviceAddDependentUsageDeviceObject aufruft, ruft das Framework die Rückruffunktionen EvtDeviceUsageNotification in den Treibern von DependentDevice auf, bevor es die Rückruffunktionen EvtDeviceUsageNotification in den Treibern des Geräts aufruft.

Ihr Treiber kann WdfDeviceAddDependentUsageDeviceObject mehrmals aufrufen, um mehrere Geräte zu identifizieren, von denen Device abhängig ist, um spezielle Dateien zu unterstützen.

Nachdem ein Treiber WdfDeviceAddDependentUsageDeviceObject aufgerufen hat, kann er WdfDeviceRemoveDependentUsageDeviceObject aufrufen, um das von DependentDevice identifizierte Gerät aus der Liste der Geräte zu entfernen, von denen Device abhängig ist.

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

Beispiele

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

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

Anforderungen

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

Weitere Informationen

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject

Freigeben über