Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique à KMDF et UMDF]
La macro WdfObjectDereferenceWithTag décré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. Cette macro affecte également une valeur d’étiquette à la référence.
Syntaxe
VOID WdfObjectDereferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
Paramètres
Handle [in]
Handle vers un objet framework.
balise [in]
Valeur définie par le pilote qui identifie une référence d’objet. La valeur de balise doit correspondre à une valeur de balise que le pilote a précédemment fournie à WdfObjectReferenceWithTag.
Valeur de retour
Aucun.
Une vérification de bogue 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 WdfObjectDereferenceWithTag retourne.
Appeler WdfObjectDereferenceActual ou WdfObjectDereferenceWithTag au lieu de WdfObjectDereference fournit des informations supplémentaires (chaîne de balise, numéro de ligne et nom de fichier) aux débogueurs Microsoft. WdfObjectDereferenceActual permet à votre pilote de spécifier le numéro de ligne et le nom de fichier, tandis que WdfObjectDereferenceWithTag 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 décrémente le nombre de références d’un objet et affecte une valeur d’étiquette à la référence.
WdfObjectDereferenceWithTag(
object,
pTag
);