WdfObjectDereferenceWithTag-macro

[Van toepassing op KMDF en UMDF]

De WdfObjectDereferenceWithTag macro maakt het aantal verwijzingen voor een opgegeven frameworkobject ongedaan en wijst de huidige bestandsnaam en het regelnummer van het stuurprogramma toe aan de verwijzing. Met deze macro wordt ook een tagwaarde aan de verwijzing toegewezen.

Syntaxis

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

Parameterwaarden

verwerken [in]
Een ingang naar een frameworkobject.

Tag [in]
Een door het stuurprogramma gedefinieerde waarde die een objectverwijzing identificeert. De tagwaarde moet overeenkomen met een tagwaarde die het stuurprogramma eerder heeft verstrekt aan WdfObjectReferenceWithTag.

Retourwaarde

Geen.

Er treedt een foutcontrole op als het stuurprogramma een ongeldige objectgreep levert.

Opmerkingen

Als het aantal verwijzingen van het object nul wordt, wordt het object mogelijk verwijderd voordat WdfObjectDereferenceWithTag retourneert.

Het aanroepen van WdfObjectDereferenceActual- of WdfObjectDereferenceWithTag in plaats van WdfObjectDereference biedt aanvullende informatie (tagtekenreeks, regelnummer en bestandsnaam) voor Microsoft-foutopsporingsprogramma's. WdfObjectDereferenceActual kunt uw stuurprogramma het regelnummer en de bestandsnaam opgeven, terwijl WdfObjectDereferenceWithTag het huidige regelnummer en de bestandsnaam van het stuurprogramma gebruikt.

U kunt de waarden voor de tag, het regelnummer en de bestandsnaam weergeven met behulp van de extensie !wdftagtracker foutopsporingsprogramma. De extensie voor foutopsporingsprogramma geeft de tagwaarde weer als een aanwijzer en een reeks tekens. Zie Foutopsporing van een KMDF-stuurprogrammavoor meer informatie over extensies voor foutopsporingsprogramma's.

Zie Framework Object Life Cyclevoor meer informatie over het aantal objectverwijzingen.

Voorbeelden

In het volgende codevoorbeeld wordt het aantal naslaginformatie van een object verwijderd en wordt een tagwaarde aan de verwijzing toegewezen.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Vereisten

Doelplatform	Universal
Minimale KMDF-versie	1.0
Minimale UMDF-versie	2.0
Koptekst	Wdfobject.h (inclusief Wdf.h)
Bibliotheek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL

Zie ook

WdfObjectDereference-

WdfObjectReferenceWithTag-