Función RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

  • Artículo

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

Sintaxis

NTSTATUS RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Parámetros

[in] pRxContext

Puntero al RX_CONTEXT. Este parámetro proporciona el contexto de la operación para un tratamiento especial mediante el seguimiento interno de RDBSS si esta característica está habilitada.

Fcb

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

Valor devuelto

RxAcquireSharedFcbResourceInMRxEx devuelve STATUS_SUCCESS si se ha realizado 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 están asociados 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.

RxAcquireSharedFcbResourceInMRxEx 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.

Se debe publicar un recurso FCB adquirido con RxAcquireSharedFcbResourceInMRxEx llamando a RxReleaseFcbResourceInMRx o RxReleaseFcbResourceForThreadInMRx.

Requisitos

Requisito Value
Cliente mínimo compatible La rutina RxAcquireSharedFcbResourceInMRxEx solo está disponible en Windows Server 2003 Service Pack 1 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado mrxfcb.h (incluya Mrxfcb.h)
IRQL <= APC_LEVEL

Consulte también

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx