Macro WdfObjectReference

[S’applique à KMDF et UMDF]

La macro WdfObjectReference incrémente le nombre de références pour un objet framework spécifié.

Syntaxe

VOID WdfObjectReference(
  [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 votre pilote appelle WdfObjectReference pour incrémenter un nombre de références, le pilote doit appeler WdfObjectDereference pour décrémenter le nombre.

Au lieu d’appeler WdfObjectReference, un pilote peut appeler WdfObjectReferenceWithTag ou WdfObjectReferenceActual.

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

Exemples

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

WdfObjectReference(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

Voir aussi

WdfObjectReferenceActual

WdfObjectReferenceWithTag