RxAcquireExclusiveFcbResourceInMRx routine

RxAcquireExclusiveFcbResourceInMRx acquires the FCB resource for a network mini-redirector driver in exclusive mode. This routine will wait for the FCB resource to be free if it was previously acquired and does not return control until the exclusive resource has been acquired.

Syntax


NTSTATUS RxAcquireExclusiveFcbResourceInMRx(
  _Inout_ PMRX_FCB pFcb
);

Parameters

pFcb [in, out]

A pointer to the FCB. This parameter is required and cannot be NULL.

Return value

RxAcquireExclusiveFcbResourceInMRx returns STATUS_SUCCESS on success or one of the following error codes on failure:

Return codeDescription
STATUS_LOCK_NOT_GRANTED

The FCB resource was not acquired.

 

Remarks

The synchronization resources of interest to a network mini-redirector driver are primarily associated with the FCB. There is a paging I/O resource and a regular resource. The paging I/O resource is managed internally by RDBSS. The only resource accessible to a network mini-redirector driver is the regular resource which should be accessed using RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx, or RxAcquireSharedFcbResourceInMRx, depending on the acquired mode desired.

RxAcquireExclusiveFcbResourceInMRx will wait for the FCB resource to be free if it was previously acquired and does not return control until the exclusive resource has been acquired. This routine acquires the FCB resource even if the RX_CONTEXT associated with this FCB has been canceled.

An FCB resource acquired with RxAcquireExclusiveFcbResourceInMRx should be released by calling RxReleaseFcbResourceInMRx or RxReleaseFcbResourceForThreadInMRx.

Requirements

Target platform

Desktop

Header

Mrxfcb.h (include Mrxfcb.h)

IRQL

<= APC_LEVEL

See also

RxAcquireSharedFcbResourceInMRx
RxAcquireSharedFcbResourceInMRxEx
RxReleaseFcbResourceForThreadInMRx
RxReleaseFcbResourceInMRx

 

 

Send comments about this topic to Microsoft

Show: