WdfDeviceAddDependentUsageDeviceObject, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La méthode WdfDeviceAddDependentUsageDeviceObject indique qu’un appareil spécifié dépend d’un autre appareil lorsque l’appareil spécifié est utilisé pour stocker fichiers spéciaux.

Syntaxe

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] DependentDevice

Pointeur vers une structure de DEVICE_OBJECT fournie par l’appelant qui identifie un appareil qui appareil dépend.

Valeur de retour

Si l’opération réussit, méthode WdfDeviceAddDependentUsageDeviceObject retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

Retourner le code	Description
STATUS_INVALID_PARAMETER	dependentDevice est NULL.
STATUS_INSUFFICIENT_RESOURCES	Échec de l’allocation de mémoire.

La méthode peut retourner d’autres valeurs NTSTATUS .

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Votre pilote peut appeler WdfDeviceAddDependentUsageDeviceObject pour indiquer que l’appareil identifié par Device dépend de l’appareil identifié par DependentDevice, quand Device prend en charge des fichiers spéciaux. Si votre pilote appelle WdfDeviceAddDependentUsageDeviceObject, l’infrastructure appelle les fonctions de rappel EvtDeviceUsageNotification dans les pilotes de DependentDevice's avant d’appeler les fonctions de rappel EvtDeviceUsageNotification dans pilotes de Device's.

Votre pilote peut appeler WdfDeviceAddDependentUsageDeviceObject plusieurs fois pour identifier plusieurs appareils qui Device dépend de la prise en charge des fichiers spéciaux.

Une fois qu’un pilote a appelé WdfDeviceAddDependentUsageDeviceObject, il peut appeler WdfDeviceRemoveDependentUsageDeviceObject supprimer l’appareil identifié par DependentDevice de la liste des appareils dont dépend Device.

Pour plus d’informations sur les fichiers spéciaux, consultez Prise en charge des fichiers spéciaux.

Exemples

L’exemple de code suivant ajoute un appareil (pDeviceObject) à la liste des appareils dont dépend un autre appareil (Device).

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject

Partager via