WdfObjectDereferenceActual, fonction (wdfobject.h)

[S’applique à KMDF et UMDF]

La méthode WdfObjectDereferenceAct ual décrémente le nombre de références d’un objet framework spécifié et affecte une valeur de balise, un numéro de ligne et un nom de fichier à la référence.

Syntaxe

VOID WdfObjectDereferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in, optional] PCCH      File
);

Paramètres

[in] Handle

Handle vers un objet framework.

[in, optional] Tag

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 à WdfObjectReferenceActual.

[in] Line

Valeur numérique qui représente un numéro de ligne dans un fichier source du pilote.

[in, optional] File

Pointeur vers une chaîne de caractères constantes terminée par null qui représente le nom d’un fichier source de pilote. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Si le nombre de références de l’objet devient zéro, l’objet peut être supprimé avant WdfObjectDereferenceActual 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 et les règles de nettoyage d’une hiérarchie d’objets framework, 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, un numéro de ligne et un nom de fichier à la référence.

WdfObjectDereferenceActual(
                           object,
                           pTag,
                           line,
                           FILE_NAME
                           );

Spécifications

Voir aussi

WdfObjectDereference

WdfObjectReferenceActual