WdfObjectDereference-macro
[Van toepassing op KMDF en UMDF]
De WdfObjectDereference macro maakt het aantal verwijzingen voor een opgegeven frameworkobject ongedaan.
Syntaxis
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
Parameterwaarden
verwerken [in]
Een ingang naar een frameworkobject.
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 WdfObjectDereference retourneert.
Een stuurprogramma kan WdfObjectDereference alleen aanroepen als dit eerder WdfObjectReferenceheeft aangeroepen.
In plaats van WdfObjectDereference-aan te roepen, kan een stuurprogramma WdfObjectDereferenceWithTag of WdfObjectDereferenceActualaanroepen.
Zie Framework Object Life Cyclevoor meer informatie over het aantal objectverwijzingen.
Voorbeelden
In het volgende codevoorbeeld wordt het aantal referentiegegevens van een object verwijderd.
WdfObjectDereference(Object);
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 |
DDI-nalevingsregels |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |