Macro WdfObjectDereference

[S’applique à KMDF et UMDF]

La macro WdfObjectDereference décrémente le nombre de références pour un objet framework spécifié.

Syntaxe

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Paramètres

Handle [in]
Handle vers un objet framework.

Valeur de retour

Aucun.

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

Remarques

Si le nombre de références de l’objet devient zéro, l’objet peut être supprimé avant WdfObjectDereference retourne.

Un pilote peut appeler WdfObjectDereference uniquement s’il a déjà appelé WdfObjectReference.

Au lieu d’appeler WdfObjectDereference, un pilote peut appeler WdfObjectDereferenceWithTag ou WdfObjectDereferenceActual.

Pour plus d’informations sur les nombres de références d’objets, consultez Framework Object Life Cycle.

Exemples

L’exemple de code suivant décrémente le nombre de références d’un objet.

WdfObjectDereference(Object); 

Spécifications

Voir aussi

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference