WdfDeviceAddDependentUsageDeviceObject-Funktion (wdfdevice.h)

  • Artikel

[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