Delen via


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

Zie ook

WdfObjectDereferenceActual-

WdfObjectDereferenceWithTag-

WdfObjectReference-