Partager via


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 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 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 les nombres 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); 

Spécifications

Plateforme cible

universel

Version minimale de KMDF

1.0

Version minimale de UMDF

2.0

En-tête de page

Wdfobject.h (include 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