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 |