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 |