Skip to content

Latest commit

 

History

History
143 lines (107 loc) · 5.67 KB

nc-wdfobject-evt_wdf_object_context_destroy.md

File metadata and controls

143 lines (107 loc) · 5.67 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:wdfobject.EVT_WDF_OBJECT_CONTEXT_DESTROY
EVT_WDF_OBJECT_CONTEXT_DESTROY (wdfobject.h)
A driver's EvtDestroyCallback event callback function performs operations that are associated with the deletion of a framework object.
wdf\evtdestroycallback.htm
wdf
02/26/2018
EVT_WDF_OBJECT_CONTEXT_DESTROY callback function
DFGenObjectRef_a9194b33-b67b-43bb-8d50-d918576769c0.xml, EVT_WDF_OBJECT_CONTEXT_DESTROY, EVT_WDF_OBJECT_CONTEXT_DESTROY callback, EvtDestroyCallback, EvtDestroyCallback callback function, kmdf.evtdestroycallback, wdf.evtdestroycallback, wdfobject/EvtDestroyCallback
wdfobject.h
Wdf.h
Universal
1.0
2.0
See Remarks section.
Windows
EVT_WDF_OBJECT_CONTEXT_DESTROY
wdfobject/EVT_WDF_OBJECT_CONTEXT_DESTROY
APIRef
kbSyntax
UserDefined
Wdfobject.h
EVT_WDF_OBJECT_CONTEXT_DESTROY

EVT_WDF_OBJECT_CONTEXT_DESTROY callback function

-description

[Applies to KMDF and UMDF]

A driver's EvtDestroyCallback event callback function performs operations that are associated with the deletion of a framework object.

-parameters

-param Object [in]

A handle to a framework object.

-remarks

The driver can specify an EvtDestroyCallback callback function in a WDF_OBJECT_ATTRIBUTES structure. This structure is used as input to all of the framework methods that create framework objects, such as WdfDeviceCreate.

The framework calls the EvtDestroyCallback callback function after the object's reference count has been decremented to zero. The framework deletes the object immediately after the EvtDestroyCallback callback function returns.

The EvtDestroyCallback can access the object context but cannot call any methods on the object.

If a driver supplies both an EvtCleanupCallback callback function and an EvtDestroyCallback callback function for an object, the framework calls the EvtCleanupCallback callback function first.

When an object is deleted, the framework also deletes the object's children. The framework calls the child objects' EvtCleanupCallback callback functions before calling the parent object's EvtCleanupCallback callback function. Next, if the child's reference count is zero, the framework calls the child object's EvtDestroyCallback callback function. Finally, if the parent's reference count is zero, the framework calls the parent object's EvtDestroyCallback callback function.

When a driver creates an object, it sometimes allocates object-specific memory buffers and stores the buffer pointers in the object's context space. The driver's EvtCleanupCallback or EvtDestroyCallback callback function can deallocate these memory buffers.

For more information about deleting framework objects, see Framework Object Life Cycle.

Typically, the framework calls the EvtDestroyCallback callback function at IRQL <= DISPATCH_LEVEL. However, the framework calls the callback function at IRQL = PASSIVE_LEVEL in the following situations:

  • The object's handle type is WDFDEVICE, WDFDRIVER, WDFDPC, WDFINTERRUPT, WDFIOTARGET, WDFQUEUE, WDFSTRING, WDFTIMER, or WDFWORKITEM.
  • The object's handle type is WDFMEMORY or WDFLOOKASIDE, and the driver has specified PagedPool for the PoolType parameter to WdfMemoryCreate or WdfLookasideListCreate.
Beginning with version 1.9 of the framework, the wdfroletypes.h header file contains some alternative, object type-specific, function types for the EvtDestroyCallback callback function. These alternative types help verification tools to determine whether the driver is properly using the callback function. Use the following table to determine which function type to use.
Object Type Function Type
Device object EVT_WDF_DEVICE_CONTEXT_DESTROY
I/O queue object EVT_WDF_IO_QUEUE_CONTEXT_DESTROY_CALLBACK
File object EVT_WDF_FILE_CONTEXT_DESTROY_CALLBACK
All other objects EVT_WDF_OBJECT_CONTEXT_DESTROY

-see-also

EvtCleanupCallback

WDF_OBJECT_ATTRIBUTES