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