RxDereferenceAndDeleteRxContext_Real function (rxcontx.h)
RxDereferenceAndDeleteRxContext_Real dereferences an RX_CONTEXT data structure and if the ReferenceCount member goes to zero, then it deallocates and removes the specified RX_CONTEXT structure from the RDBSS in-memory data structures.
Syntax
void RxDereferenceAndDeleteRxContext_Real(
[in] IN PRX_CONTEXT RxContext
);
Parameters
[in] RxContext
A pointer to the RX_CONTEXT structure to be removed.
Return value
None
Remarks
RxDereferenceAndDeleteRxContext_Real is called by routines other than RxCompleteRequest during asynchronous requests that touch the RxContext parameter in either the initiating thread or in some other thread. Thus, the RX_CONTEXT data structure is reference counted and finalized on the last dereference.
If the ReferenceCount member of the RX_CONTEXT structure pointed to by the RxContext parameter is not zero after being dereferenced (decremented) by the RxDereferenceAndDeleteRxContext_Real routine, then RxDereferenceAndDeleteRxContext_Real causes the system to ASSERT on checked builds.
The RxDereferenceAndDeleteRxContext_Real routine makes a number of specific checks before removing an RX_CONTEXT. These checks include the following:
- If the AcquireReleaseFcbTrackerX member is 0, then RxDereferenceAndDeleteRxContext_Real causes the system to ASSERT on checked builds.
- If the NumberOfActiveContexts member of the associated RDBSS_DEVICE_OBJECT structure pointed to RxContext->RxDeviceObject is not zero after being dereferenced (decremented) and the StartStopContext.pStopContext member of the associated RDBSS_DEVICE_OBJECT structure is not NULL, then RxDereferenceAndDeleteRxContext_Real will signal the SyncEvent on the RX_CONTEXT structure in the StartStopContext.pStopContext member.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | rxcontx.h (include Rxprocs.h rxcontx.h) |
| IRQL | <= APC_LEVEL |
See also
RxResumeBlockedOperations_Serially