Función RxAcquireSharedFcbResourceInMRx (mrxfcb.h)

Artículo
02/29/2024

RxAcquireSharedFcbResourceInMRx adquiere el recurso FCB para un controlador minidirector de red en modo compartido. Esta rutina esperará a que el recurso FCB sea libre si se adquirió previamente exclusivamente y no devuelve el control hasta que se haya adquirido el recurso compartido.

Sintaxis

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parámetros

Fcb

Puntero al FCB. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

RxAcquireSharedFcbResourceInMRx devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes códigos de error en caso de error:

Código devuelto	Descripción
STATUS_LOCK_NOT_GRANTED	No se adquirió el recurso FCB.
STATUS_CANCELLED	Se canceló el RX_CONTEXT asociado al FCB.

Comentarios

Los recursos de sincronización de interés para un controlador minidirector de red se asocian principalmente con el FCB. Hay un recurso de E/S de paginación y un recurso normal. RDBSS administra internamente el recurso de E/S de paginación. El único recurso accesible para un controlador minidirector de red es el recurso normal al que se debe tener acceso mediante RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx o RxAcquireSharedFcbResourceInMRx, según el modo adquirido deseado.

RxAcquireSharedFcbResourceInMRx esperará a que el recurso FCB sea libre si se adquirió anteriormente exclusivamente y no devuelve el control hasta que se haya adquirido el recurso compartido. Esta rutina adquiere el recurso FCB incluso si se ha cancelado el RX_CONTEXT asociado a este FCB.

Un recurso FCB adquirido con RxAcquireSharedFcbResourceInMRx debe publicarse llamando a RxReleaseFcbResourceInMRx o RxReleaseFcbResourceForThreadInMRx.