PMRX_FINALIZE_NET_ROOT_CALLDOWN callback function (mrx.h)

Article
10/12/2023

The MRxFinalizeNetRoot routine is called by RDBSS to request that a network mini-redirector finalize a NET_ROOT structure.

Syntax

PMRX_FINALIZE_NET_ROOT_CALLDOWN PmrxFinalizeNetRootCalldown;

NTSTATUS PmrxFinalizeNetRootCalldown(
  IN OUT PMRX_NET_ROOT NetRoot,
  IN PBOOLEAN Force
)
{...}

Parameters

NetRoot

[in, out] A pointer to the NET_ROOT structure to finalize.

Force

[in] A pointer to a Boolean value that indicates if the disconnect is to be forced. RDBSS currently passes FALSE for this parameter in all cases.

Return value

MRxFinalizeNetRoot returns STATUS_SUCCESS on success.

Remarks

MRxFinalizeNetRoot is called by RDBSS when RDBSS finalizes a NET_ROOT structure. Because a NET_ROOT structure is always associated with one or more V_NET_ROOT structures, this finalization normally occurs when the last V_NET_ROOT structure on the NET_ROOT structure is finalized.

RDBSS ignores the return value from MRxFinalizeNetRoot.

Requirements

Requirement	Value
Target Platform	Desktop
Header	mrx.h (include Mrx.h)

Share via