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

Handle [in]
Handle pour un objet framework.

Aucun.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

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.

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

WdfObjectDereference(Object);

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