Macro WdfObjectReferenceWithTag

Article
06/15/2023

[S’applique à KMDF et UMDF]

La macro WdfObjectReferenceWithTag incrémente le nombre de références d’un objet framework spécifié et affecte le nom de fichier actuel et le numéro de ligne du pilote à la référence. La macro affecte également une valeur d’étiquette à la référence.

Syntaxe

VOID WdfObjectReferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

Paramètres

Gérer [in]
Handle d’un objet framework.

Balise [in]
Valeur définie par le pilote que l’infrastructure stocke en tant que balise d’identification pour la référence d’objet.

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 WdfObjectReferenceWithTag pour incrémenter un nombre de références, le pilote doit appeler WdfObjectDereferenceWithTag pour décrémenter le nombre.

L’appel de WdfObjectReferenceActual ou WdfObjectReferenceWithTag au lieu de WdfObjectReference fournit des informations supplémentaires (valeur de la balise, numéro de ligne et nom de fichier) aux débogueurs Microsoft. WdfObjectReferenceActual permet à votre pilote de spécifier le numéro de ligne et le nom du fichier, tandis que WdfObjectReferenceWithTag utilise le numéro de ligne et le nom de fichier actuels du pilote.

Vous pouvez afficher les valeurs de balise, de numéro de ligne et de nom de fichier à l’aide de l’extension de débogueur !wdftagtracker . L’extension de débogueur affiche la valeur de balise sous la forme d’un pointeur et d’une série de caractères. Pour plus d’informations sur les extensions de débogueur, consultez Débogage d’un pilote KMDF.

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 et affecte une valeur de balise à la référence.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

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

Voir aussi

WdfObjectReference

Partager via