WdfDeviceAddDependentUsageDeviceObject-Funktion (wdfdevice.h)
[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 |
|---|---|
|
DependentDevice ist NULL. |
|
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) |