PMRX_FINALIZE_SRVCALL_CALLDOWN callback function (mrx.h)

The MRxFinalizeSrvCall routine is called by RDBSS to request that a network mini-redirector finalize an SRV_CALL structure.

Syntax

PMRX_FINALIZE_SRVCALL_CALLDOWN PmrxFinalizeSrvcallCalldown;

NTSTATUS PmrxFinalizeSrvcallCalldown(
  IN OUT PMRX_SRV_CALL SrvCall,
  IN BOOLEAN Force
)
{...}

Parameters

SrvCall

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

Force

[in] A pointer to a Boolean value that indicates if the disconnect is to be enforced immediately, ignoring the reference count on the SRV_CALL structure. The Force parameter is the ForceFinalize parameter passed to the RxFinalizeSrvCall routine. This action triggers a call to MRxFinalizeSrvCall.

Return value

MRxFinalizeSrvCall returns STATUS_SUCCESS on success.

Remarks

MRxFinalizeSrvCall is called when RDBSS is tearing down an SRV_CALL structure. The network mini-redirector is expected to close its connection to the server.

MRxFinalizeSrvCall is called by RDBSS after receiving an RxFinalizeSrvCall call. If RxFinalizeSrvCall is called from a different process than the RDBSS system process, then the call to MRxFinalizeSrvCall is posted to a worker thread for later execution. At some later time RxFinalizeSrvCall is called to complete the finalization of the SRV_CALL structure.

RDBSS ignores the return value from the MRxFinalizeSrvCall call.

Requirements

See also

MRxCreateSrvCall

MRxCreateVNetRoot

MRxExtractNetRootName

MRxFinalizeNetRoot

MRxFinalizeVNetRoot

MRxPreparseName

MRxSrvCallWinnerNotify

RxFinalizeSrvCall