Macro WdfObjectReferenceWithTag

[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

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

L’appel WdfObjectReferenceActual ou WdfObjectReferenceWithTag au lieu de WdfObjectReference fournit des informations supplémentaires (valeur de 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 de 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 !wdftagtracker du débogueur. L’extension du débogueur affiche la valeur de balise comme pointeur et 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 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 et affecte une valeur d’étiquette à la référence.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

Spécifications

Voir aussi

WdfObjectReference