Partager via


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 pour un objet framework.

Valeur retournée

Aucun.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

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

Un pilote peut appeler WdfObjectDereference uniquement s’il a précédemment appelé WdfObjectReference.

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

Pour plus d’informations sur le nombre 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); 

Configuration requise

Plateforme cible

Universal

Version KMDF minimale

1.0

Version UMDF minimale

2.0

En-tête

Wdfobject.h (inclure Wdf.h)

Bibliothèque

Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

Règles de conformité DDI

DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

Voir aussi

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference